change webdoc.md

docs/community/webdoc.md

@@ -1,3 +1,125 @@
 # 为XiUOS 完善网站文档
 
+## 准备阶段
+首先，从XiUOS主库中复刻一份到自己的个人空间。
+假定您在Trustie的用户名为“panda”
+
+## 步骤1：复刻
+再在浏览器中打开XiUOS的项目首页[https://forgeplus.trustie.net/projects/xuos/xiuos](https://forgeplus.trustie.net/projects/xuos/xiuos), 点击右上角的"复刻" 按钮
+
+这样您就在自己的个人空间中有了XiUOS的一个复刻代码库, 地址为
+
+项目首页为 "https://forgeplus.trustie.net/projects/panda/xiuos"
+
+代码库地址为 "https://git.trustie.net/panda/xiuos.git"
+
+### 步骤2 : 下载到本地，并配置
+
+* 从个人空间下载
+
+```
+git clone https://git.trustie.net/panda/xiuos.git
+```
+
+::: warning     警告
+请务必记住，将panda替换为您自己的用户名
+:::
+
+* 配置
+
+```
+# 设置 upstream
+git remote add upstream https://git.trustie.net/xuos/xiuos.git
+# 禁止直接向 upstream 推送代码
+git remote set-url --push upstream no_push
+
+## 工作阶段
+
+### 步骤3 : fetch
+
+从 **upstream(xuos/xiuos)** fetch 代码到本地
+
+```
+git fetch upstream
+```
+
+### 步骤4 : branch
+
+为本次工作创建一个分支，命名为 `develop`
+
+```
+git checkout -b develop upstream/master
+```
+
+### 步骤5 : work, commit & commit
+
+此时就可以在该分支下工作了, 不断修改代码，不断 commit
+
+```
+git add .
+
+git commit -m "your commit message"
+```
+
+### 步骤6 : push & push
+
+如果经过测试，您觉得在本地完成了代码工作，您就可以将代码推送到您自己的服
+务器端的仓库中了。
+
+git push origin develop
+```
+
+push到自己的服务器端库中后，就可以准备创建`合并请求(Pull Request)`了。
+
+### 步骤7 : fetch
+
+从XiUOS的主库, 即 upstream 中, fetch 最新的代码
+
+```
+git fetch upstream
+```
+
+### 步骤8 : merge
+
+将upstream 上最新的代码合并到你的当前工作分支
+
+```
+git merge upstream/master
+```
+
+此时请确保本地您位于工作分支。如果合并过程有冲突，您要负责解决冲突，并提交。
+
+### 步骤9 : push
+
+将消解了冲突的最新本地代码，推送到个人服务器端仓库的develop分支。
+
+```
+git push origin develop
+```
+
+### 步骤10 : 合并请求(pull request)
+
+到自己个人服务器端仓库的首页 https://forgeplus.trustie.net/projects/panda/xiuos, 点击 **合并请求** ,
+
+设置源分支:
+
+选择 设定的工作分支, 本文的例子是 **develop** 分支
+
+设置目标分支:
+
+目标仓库选择 upstream 库, 即: "泛在操作系统实验室/xiuos"
+
+目标分支选择 `master`
+
+提交即可。
+
+如果您的"合并请求"被核心开发者拒绝, 这种情况在开源社区很常见，所以请不要灰心失望, 请按照返回的意见修改完善，再提交即可。
+
+### 更新本地和个人服务器端仓库的主分支
+
+```
+git fetch upstream
+git checkout master
+git merge upstream/master
+git push origin master