-
Notifications
You must be signed in to change notification settings - Fork 135
工作流程
kiler398 edited this page Jun 19, 2016
·
11 revisions
https://raw.githubusercontent.com/dotnetcore/aspnetcore-doc-cn/dev/%E5%AE%A1%E6%A0%B8.jpg
- 安装Python3.4,https://www.python.org/
- 根据 https://github.com/aspnet/Docs/blob/master/CONTRIBUTING.md 安装shpinx
- 安装 Visual Studio Code 最新版 https://www.visualstudio.com/en-us/products/code-vs.aspx
- 安装 Visual Studio Code 的插件 https://marketplace.visualstudio.com/items?itemName=tht13.rst-vscode
- 安装Git, https://git-scm.com/download (若已安装,可跳过此步)。
- Fork 文档 到自己的 Github , https://github.com/dotnetcore/aspnetcore-doc-cn
- 去 Github 查看分配给自己的文章
- 开工前检查一下官方文档( https://github.com/aspnet/Docs) 是否有更新,若有更新,更新之后再翻译(可手动更新或将官方版本设置远程仓储合并)
- 在本地为这篇文章的翻译任务创建一个分支(建议分支名 branche_kiler_tran_DOC_02_14_00x 可能会有多次翻译,比如文档更新了以后),在这个分支上翻译文章。
- 翻译完成后,执行 make html 命令(准备阶段第一步中提及) 生成html自行检查,检查通过在分支中 pull request 到 https://github.com/dotnetcore/aspnetcore-doc-cn 的 dev 分支下,更新issue状态Lable,等待管理员接收且安排审核工作。
- 管理员接收到文章翻译玩的pr以后,然后把审核者加一个新的assigner 更新issue状态
- 审核者看到有审核任务,把项目fork到本地,为这次审核任务单开一个分支(建议分支名 branche_Seay_check_DOC_02_14_00x 可能会有多次审核),审核者本地修改审核完毕以后发pr,然后通知原作者审核。
- 原作者看到pr要审阅,不能直接接收,如果不同意某些审核,在对应位置备注,和审核者协商,由审核者修改,并commit,无需二次pr(如果拿不准,主群讨论)
- 原作者直到pr里面没有任何问题了才全部接受,审核流程完毕
果还有审核,再次走4,5,6,7
- 首先为需要翻译的文章创建一条issue,比如【翻译】 DOC-02-04-10 Examining the Details and Delete (强制要求issue的命名格式为 【翻译】 + 文章编号 + 文章英文原文名 ) (如果文章重新翻译建议不要开新的issue了,reopen老的issue) issue 正文内容如下: 原文地址 :https://docs.asp.net/en/latest/tutorials/first-mvc-app/details.html Dev地址 :https://github.com/dotnetcore/aspnetcore-doc-cn/blob/dev/aspnet/tutorials/first-mvc-app/details.rst
- 设置assigner把任务分配给翻译者 如 kiler,设置好对应的lable,如已领取
- 翻译者在本地按照原有流程进行翻译。先从Github fork 项目到自己的库,然后为这一篇文章的修改创建一个分支(建议分支名 branche_kiler_tran_DOC_02_14_00x 可能会有多次翻译,比如文档更新了以后),自己在分支上修改,当第一次全部翻译完成以后。分支发pull request (强制要求pull request的命名格式为 【翻译】 + 翻译者 + 日期序号(20160611001) + 文章编号 + 文章英文原文名 可能名称要加issue# A大补充) 到dev要求接受,pull request 关联到之前的issue #。同时把label更新为待审核。
- 管理员接收pr,然后把审核者加一个新的assigner 比如武汉-Seay ,修改lable,审核中
- 审核者看到有审核任务,把项目fork到本地,为这次审核任务单开一个分支(建议分支名 branche_Seay_check_DOC_02_14_00x 可能会有多次审核),审核者本地修改审核完毕以后发pr(强制要求pull request的命名格式为 【审核】 + 审核者 + 日期序号(20160611001) + 文章编号 + 文章英文原文名 可能名称要加issue# A大补充),然后通知原作者审核。
- 原作者看到pr要审阅,不能直接接收,如果不同意某些审核,在对应位置备注,和审核者协商,由审核者修改,并commit,无需二次pr(如果拿不准,主群讨论)
- 原作者直到pr里面没有任何问题了才全部接受,审核流程完毕
- 如果还有审核,再次走4,5,6,7
- 最后发表并入master