维护¶
文档全部被翻译并不代表所有的事情都已经完成。文档库是不断变更的(新文档被加入,bugs被修正,段落被重新组织)。翻译团队需要紧随官方英语文档库并且尽快实现翻译后的变更。
警告
不再被维护的文档库将从官方列表中移除,因为过期的文档对于开发可能会造成不可预料的后果
发布于 2015-08-27 16:47:24 | 202 次阅读 | 评论: 0 | 来源: 网络整理
Symfony文档用英语书写,许多人都加入到了翻译的进程中。
注解
Symfony Project officially discourages from starting new translations for the documentation. As a matter of fact, there is an ongoing discussion in the community about the benefits and drawbacks of community driven translations.
首先熟悉文档使用的 标记语言。
然后加入到 Symfony docs mailing-list ,通过邮件合作。
最后,找到你想要参与贡献文档的 master 主文档库,下列是官方 master 主文档库:
注解
If you want to contribute translations for a new language, read the dedicated section.
如果你想贡献新语种的文档,请参考:
通过 Symfony docs mailing-list 介绍自己
(可选) 询问你可以参与的文档
Fork master 主文档库
翻译
创建 pull request
文档管理员接受你的提交并合并到主文档库
文档网站自动从主文档库更新
这一小节简要介绍如何添加新的文档库语言
因为翻译工作需要大量精力,所以首先通过邮件组 Symfony docs mailing-list 谈谈你的计划,并且试着找到合作伙伴。
当团队人员就绪,选出一名团队管理员,他们将负责 master 主文档库。
创建库并复制 英语 文档库。
团队便可以开始翻译了
当团队认为文档库已经处于一致并且稳定的状态时(所有文档都被翻译,未翻译的文档从toctrees已经移除),
文档全部被翻译并不代表所有的事情都已经完成。文档库是不断变更的(新文档被加入,bugs被修正,段落被重新组织)。翻译团队需要紧随官方英语文档库并且尽快实现翻译后的变更。
警告
不再被维护的文档库将从官方列表中移除,因为过期的文档对于开发可能会造成不可预料的后果