Xray-docs-next/docs/document/document.md

48 lines
1.5 KiB
Markdown
Raw Normal View History

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. 在新分支上做修改。
2022-12-24 05:06:47 +00:00
注:推荐 [中文文案排版指北](https://github.com/sparanoid/chinese-copywriting-guidelines)
2021-03-26 03:42:06 +00:00
2022-12-24 05:06:47 +00:00
5. 修改完成后,请使用 [Prettier](https://prettier.io/docs/en/install.html) 格式化您的更改。
2021-03-26 03:42:06 +00:00
2022-12-24 05:06:47 +00:00
注:存在格式问题的 PR将有可能被拒绝。
2021-03-26 03:42:06 +00:00
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。