docschina / ecma262-old Goto Github PK

View Code? Open in Web Editor NEW

This project forked from tc39/ecma262

82.0 82.0 14.0 31.78 MB

[印记中文](https://docschina.org/) - ECMA262 的状态、进度和文档

Home Page: https://ecma262.docschina.org/

License: Creative Commons Attribution 4.0 International

Shell 0.06% HTML 99.94%

ecma262-old's People

Contributors

Stargazers

Watchers

Forkers

realywithoutname soulhat qc-l sirzdy kangkai124 yiyandaoren rhinomangit aidandai fangyinghua meteorshower2013 chorer peterzhangsnail ssrkaze isildur46

ecma262-old's Issues

ECMAScript®语言规范中文翻译工作计划与进度表格

不定期更新任务
原则上任务从上到下认领
每个任务工作量尽量控制在两周内（10小时）完成
对于任务工作量大的，请在下面评论或私聊
对于关联任务，最好由个人或小团队合作完成
工作流程：领取任务 -> 填写计划时间 -> 找人 review -> merge PR -> 发布 -> 修 issue

任务说明：

# 用来分隔主任务和子任务，前面部分表示主任务，后面部分表示当前任务。
& 链接当前任务内多个分支任务，每个分支任务的就是文档小节的标题。

示例：
sec-executable-code-and-execution-contexts#sec-executable-code-and-execution-contexts&sec-lexical-environments&sec-environment-records&sec-declarative-environment-records

总任务：sec-executable-code-and-execution-contexts
当前任务：sec-executable-code-and-execution-contexts&sec-lexical-environments&sec-environment-records&sec-declarative-environment-records
分支任务：sec-executable-code-and-execution-contexts 、sec-lexical-environments、sec-environment-records、sec-declarative-environment-records

其中 sec-lexical-environments、sec-environment-records、sec-declarative-environment-records 这几个都是 sec-executable-code-and-execution-contexts 这个大章节的小节，所以这里的 sec-executable-code-and-execution-contexts 实际内容就是 sec-executable-code-and-execution-contexts 、sec-lexical-environments 这两个标题之间的内容。

任务	责任人	计划时间	完成时间
sec-executable-code-and-execution-contexts#sec-executable-code-and-execution-contexts&sec-lexical-environments&sec-environment-records&sec-declarative-environment-records	@fangyinghua	2019/07/27	2019/08/11
sec-executable-code-and-execution-contexts&sec-lexical-environments&sec-environment-records#sec-object-environment-records&sec-function-environment-records	@EdisonVan	2019/07/22	2019/08/12
sec-executable-code-and-execution-contexts&sec-lexical-environments&sec-environment-records#sec-global-environment-records&sec-module-environment-records
sec-executable-code-and-execution-contexts#sec-code-realms&execution-contexts&sec-jobs-and-job-queues&sec-initializehostdefinedrealm
sec-executable-code-and-execution-contexts#sec-runjobs&sec-agents&sec-agent-clusters&sec-forward-progress

Issue	任务名	当前状态	负责人	备注
#1	Introduction	待审校	-	无
#2	第一、二、三章	待审校	-	无
#4	第四章简介部分	待审校	-	无
#5	第四章：4.1，4.2小节	待审校	-	无
#6	第四章：4.3，4.4	待审校	-	无
#7	第五章：5.1	待审校	-	无
#8	第五章：5.2	待审校	-	无
#9	第六章：6.1	翻译中	-	无
#10	第六章：6.2	翻译中	-	无
#11	第七章：7.1.1 - 7.1.5	翻译中	-	无
#12	第七章：7.1.6 - 7.1.17	翻译中	-	无
#13	第七章：7.2.1 - 7.2.5	翻译中	-	无
#14	第七章：7.2.6 - 7.2.13	翻译中	-	无
#15	第七章：7.3	翻译中	-	无
#16	第七章：7.4	翻译中	-	无
#17	第八章：8.1	待翻译	-	无
#18	第八章：8.2 - 8.6	待翻译	-	无
#19	第八章：8.7 - 8.9	待翻译	-	无
#20	第九章：9.1	待翻译	-	无
#21	第九章：9.2	待翻译	-	无
#22	第九章：9.3	待翻译	-	无
#23	第九章：9.4	待翻译	-	无
#24	第九章：9.5	待翻译	-	无

工作流程

对于一个issue的处理流程如下：

fork仓库 -> 翻译 -> 提交PR -> review翻译内容并提出建议 -> 在原PR上修改 -> 项目维护者合并 -> 审校 -> 发布

在每个阶段都会对应修改issue状态，修改issue在project中对应进度。

完成所有当前版本翻译后，从上游仓库拉取改动内容，进行新的一轮翻译。

翻译流程

所有章节遵循以下步骤进行翻译，完整的流程包括：

待翻译： 认领 待翻译 状态的任务(请通知项目维护者修改issue状态)，fork 到自己的仓库中翻译；
翻译完成： 翻译结束后提请 docschina/ecma262 对应分支 pull request，该部分翻译完成，进入 校对中 状态；
校对中： 校对人员找到自己参与校对的章节所对应的 pull request （状态为 open），利用 GitHub 网页上提供的 review 功能进行校对，校对完成后提 submit review；
校对完成 & 待审校： review 过后的 pull request 将被合并到项目中，并自动进入 待审校 状态，相应章节由审校人员认领后进入 审校中 状态；
审校完成： 审校完成后，相应章节如果有改动，将由审校人员提起一次 pull request 对相应部分进行更新；如无改动，则标定为 已审校 状态；
发布： 进入 已审校 即审校完成的章节翻译工作意味着已经完成，内容将不再改动并对外发布，并且可以通过指定中文网址进行查看；

对于同一个翻译中如果翻译了多个issue，请注意每个issue应从translated分支checkout出新分支进行翻译。以保证每个pull request的独立。

注意点

混排模式是否应该使用空格
个人建议是可以不适用空格，空格可能导致阅读体验不好(不同浏览器，不同字体都可能导致间隙不一致)。
专业词汇是否翻译
根据自己的知识及用语习惯进行判断，如果翻译请使用abbr标签记录英文原文。最后在审校过程中进行统一。

翻译状态（tag）管理

共有如下几种状态，分别对应如上流程

特有词汇

LN 表示文档行号
issues 表示github的issues菜单
pull request 表示github的pull request功能

角色

项目维护者负责对翻译分支，校对分支，cn分支的管理。
校对者负责指出新翻译内容中错译、漏译、标点符号错误、错别字、大小写、拼写错误、单复数、动词时态、数字错误等错误
翻译参与者从issues中选择自己希望翻译的内容在本地进行翻译，具体翻译流程可查看翻译流程
审校者负责对翻译内容的语句润色，通顺，专业性等工作

分支管理

translated 翻译分支。对于该分支下被合并的内容将永远存在，除非被新内容覆盖。
checking 审校分支。
cn 发布分支。使用工具进行自动部署

英文	中文
implementation	实现
ordinary object	普通对象
abrupt completion	异常结束
reference	引用
binding	组合
abstract operations	抽象操作
When XXXX is called with arguments O	当以/使用参数 O 调用 XXXX 时
Execution Contexts	执行上下文