2021-03-26 03:42:06 +00:00
|
|
|
|
# 为 Project X 的文档贡献
|
2021-03-14 07:40:53 +00:00
|
|
|
|
|
2021-03-26 03:42:06 +00:00
|
|
|
|
欢迎您为 Project X 的文档做出贡献,我们感谢每一位 Contributor 的贡献!是你们让 Xray 更加强大!
|
2021-03-14 07:40:53 +00:00
|
|
|
|
|
2021-03-26 03:42:06 +00:00
|
|
|
|
## 改进文档
|
|
|
|
|
|
|
|
|
|
Project X 的文档托管在 [GitHub](https://github.com/XTLS/Xray-docs-next) 上.
|
2021-03-14 07:40:53 +00:00
|
|
|
|
|
2021-03-26 03:42:06 +00:00
|
|
|
|
您可以通过以下步骤, 提交您对文档的改动:
|
2021-03-14 07:40:53 +00:00
|
|
|
|
|
2021-03-26 03:42:06 +00:00
|
|
|
|
1. 从 [project X 文档仓库](https://github.com/XTLS/Xray-docs-next) 打开仓库, 点击右上角的 fork, fork 一份文档仓库的镜像到您自己的 github 仓库.
|
2021-03-14 07:40:53 +00:00
|
|
|
|
|
|
|
|
|
2. 使用任何您喜欢的工具, 从您克隆的仓库获得文档的克隆, 如:
|
2021-03-26 03:42:06 +00:00
|
|
|
|
|
2021-03-14 07:40:53 +00:00
|
|
|
|
```
|
2021-03-26 03:42:06 +00:00
|
|
|
|
git clone https://github.com/XTLS/Xray-docs-next.git
|
2021-03-14 07:40:53 +00:00
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
3. 基于 main 分支创建新的分支, 如:
|
2021-03-26 03:42:06 +00:00
|
|
|
|
|
2021-03-14 07:40:53 +00:00
|
|
|
|
```
|
|
|
|
|
git checkout -b your-branch
|
|
|
|
|
```
|
|
|
|
|
|
2021-03-26 03:42:06 +00:00
|
|
|
|
4. 在新分支上做修改。
|
|
|
|
|
|
|
|
|
|
注:在修改时请注意遵循 [中文文案排版指北](https://github.com/sparanoid/chinese-copywriting-guidelines)
|
|
|
|
|
|
|
|
|
|
5. 修改完成后,请格式化您的更改。建议使用 Prettier
|
|
|
|
|
|
|
|
|
|
注:存在格式问题或不遵循中文文案排版指北的 PR,将有可能被拒绝。
|
|
|
|
|
|
|
|
|
|
6. 提交修改,并推送到您的仓库中
|
2021-03-14 07:40:53 +00:00
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
git push -u origin your-branch
|
|
|
|
|
```
|
|
|
|
|
|
2021-03-26 03:42:06 +00:00
|
|
|
|
6. 打开 GitHub, 点击 'Pull request' 向 [project X 文档仓库](https://github.com/XTLS/Xray-docs-next) 提交 PR。
|
2021-03-14 07:40:53 +00:00
|
|
|
|
|
|
|
|
|
7. 请在 PR 的标题和正文中,概述此次 PR 新增/修改的内容等;
|
|
|
|
|
|
2021-03-26 03:42:06 +00:00
|
|
|
|
8. 等待回应, 如果 PR 被 merge, 您做的修改将直接呈现在 [Project X 文档网站](https://xtls.github.io)。
|
|
|
|
|
|
|
|
|
|
## 发现问题?
|
|
|
|
|
|
|
|
|
|
如果您发现文档出错,可以改进文档或提交一个 Issue。
|