Skip to content

Commit

Permalink
Proofreading 9 (#9550)
Browse files Browse the repository at this point in the history
* proofread translation: Championing a proposal at TC39

* proofread translation: How to experiment with a proposal before Stage 4

* proofread translation: How to give helpful feedback
  • Loading branch information
PassionPenguin committed Nov 9, 2023
1 parent 84f3555 commit 9c1a6af
Show file tree
Hide file tree
Showing 3 changed files with 67 additions and 42 deletions.
91 changes: 58 additions & 33 deletions article/ECMA-TC39/Championing-a-proposal-at-TC39.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
> * 译者:[霜羽 Hoarfroster](https://github.com/PassionPenguin)
> * 校对者:[Kimhooo](https://github.com/Kimhooo)[KimYangOfCat](https://github.com/KimYangOfCat)
**本文是为 TC39 代表编写的(参见[加入 TC39](https://github.com/tc39/how-we-work/blob/master/join-tc39.md)如果您不是代表,您也可以帮助提案的发起人完成其中的一些任务,不过其中一些工作涉及在 TC39 会议上出���,以及在委员会中提供介绍和建立共识。**
**本文是为 TC39 代表编写的(参见[加入 TC39](https://github.com/tc39/how-we-work/blob/master/join-tc39.md)如果你不是代表,你也可以帮助提案的发起人完成其中的一些任务,不过其中一些工作涉及在 TC39 会议上出席,以及在委员会中提供介绍和建立共识。**

# 如何在 TC39 提起一项提案?

Expand All @@ -17,7 +17,7 @@

支持提案工作的大部分都可以在 TC39 之外完成,而不会影响委员会的批准。推进这项工作可以为晋升 TC39 中的阶段提供更多的依据,而这项工作的一些组成部分是:

- **[解释内容](https://github.com/tc39/wwe-work/blob/master/explainer.md)**在您的提案的仓库中存放一份写好的 README 文件,在更高层面解释该提案的目的和当前状况。
- **[解释内容](https://github.com/tc39/wwe-work/blob/master/explainer.md)**在你的提案的仓库中存放一份写好的 README 文件,在更高层面解释该提案的目的和当前状况。
- **[文档](https://github.com/tc39/how-we-work/issues/49)** :为 JavaScript 开发者编写的解释,以方便开发者使用该提案。
- **[实现方式](https://github.com/tc39/how-we-work/blob/master/implement.md)** :允许程序员对提案进行试验,无论借助是 Transpilers 或是 polyfills,还是需要开启一个 Flag 或使用一个原生实现的分支。
- **[测试](https://github.com/tc39/how-we-work/issues/6)** :检查实现的正确性的测试 —— 这些最初可以沿着实施方式检查,但最有用会最终迁移到 test262。
Expand All @@ -27,81 +27,98 @@

一旦提案向委员会提交,每个阶段提案都应有一个属于 TC39 组织中的 GitHub 仓库。此仓库需要包括说明程序、规范文本草稿文本,而有时还会需要草稿实施或示例程序的资源。仓库的问题跟踪人员可用于讨论委员会和社区的设计问题。这些提案仓库需要根据 [TC39 的行为准则](https://tc39.es/code-of-conde/)进行管理。

#### 阶段流程跟踪问题
#### 跟踪阶段流程的 issue

要通过各阶段流程,GitHub 仓库中的跟踪问题可能很有用。以下是您可以用于此类跟踪问题的模板
要使提案顺利通过各阶段流程,在 GitHub 仓库中建立一个用于跟踪阶段流程的 issue 可能很有用。以下是你可以用于此类跟踪 issue 的模板

```markdown
## 第四阶段
- [ ] 委员会批准

- [ ] 委员会通过
- [ ] 在两个浏览器中实现
- [ ] 显着的现场体验
- [ ] 合并 Test262 测试
- [ ] 编写 Test262 测试
- [ ] 准备 ECMA262 PR
- [ ] 编辑批准的 ECMA262 Pr
- [ ] 编辑通过的 ECMA262 PR

## 第三阶段
- [ ] 委员会批准

- [ ] 委员会通过
- [ ] 规范编辑器签名
- [ ] 规范审稿人签名
- [ ] 接收开发者/实现者反馈
- [ ] 接收开发者/实现者的反馈

## 第二阶段
- [ ] 委员会批准

- [ ] 委员会通过
- [ ] 编写的规范文本
- [ ] 选择规范审稿人

## 第一阶段

- [ ] 引入 TC39
- [ ] 确定提议者
- [ ] 初始解释内容
- [ ] 确立解释内容
```

## 在委员会阶段的晋升

这部分建立在[阶段过程文档](https://tc39.es/process-document/)的基础上,提出了一些可能会对各自阶段有利的做法。
这部分建立在[阶段过程的官方文档](https://tc39.es/process-document/)的基础上,提出了一些可能会对各自阶段有利的做法。

阶段的晋升出现在 TC39 会议上,委员会将基于向委员会提交的提案,在全体投票决定后将决定该提案应该向哪一个具体的阶段推进。有关更多详细信息,请参阅[演示建议](https://github.com/tc39/how-we-work/blob/master/presenting.md)
阶段的推进出现在 TC39 会议中。委员会将基于向委员会提交的提案,在全体投票决定后将决定该提案应该向哪一个具体的阶段推进。有关更多详细信息,请参阅[演示建议](https://github.com/tc39/how-we-work/blob/master/presenting.md)

### 第一阶段

流程文件的入场标准:
入门门槛:

> - 确定将助力推进提案的“发起人”
> - 概述问题需要,并提出解决方案的轮廓大纲
> - 使用的说明性示例
> - 高级 API
> - 讨论关键算法、抽象和语义
> - 识别潜在的“交叉”关注和实施挑战/复杂性
> - 识别潜在的“交叉”关注和实施的困难程度/复杂性
通过的意义:

验收意味着:
> 委员会预计将有时间审查问题空间、解决方案和交叉削减问题
进入第一阶段
- **确定委员会中的发起人(或提议团体)**。不幸的是,TC39 没有为非委员会成员找到一个合适的委员会导师/发起人的方法,但是现有的论坛包括 [TC39 讨论论坛](https://es.discourse.group)[es-discuss 邮件列表](https://esdiscuss.org)可能会对此有所帮助;另一个是 Freenode 上的 IRC 频道 `#tc39`[详细信息](https://freenode.net/kb/answer/chat))。当然,你也可以在 Twitter 上找到许多的 TC39 代表。
进入第一阶段:

- **确定委员会中的发起人(或提议团体)**。不幸的是,TC39 没有为非委员会成员提供找到一个合适的委员会代表/发起人的方法,但是现有的论坛包括 [TC39 讨论论坛](https://es.discourse.group)[es-discuss 邮件列表](https://esdiscuss.org)可能会对此有所帮助;另一个是 Freenode 上的 IRC 频道 `#tc39`[详细信息](https://freenode.net/kb/answer/chat))也有可能有所帮助。当然,你也可以在 Twitter 上找到许多的 TC39 代表。
- **写一个解释文档**。请参阅 [explainer.md](https://github.com/tc39/how-we-work/blob/master/explainer.md),以获取有关如何编写入门文档以满足第一阶段其余要求的建议。
- **准备演示文稿**,以使委员会考虑他们在该设计领域中想要做的事情,如果您有特定的想法,请向该方向发展。有关演示文稿的建议,请参见[presenting.md](https://github.com/tc39/how-we-work/blob/master/presenting.md)
- **准备演示文稿**,以使委员会考虑他们在该设计领域中想要做的事情,如果你有特定的想法,请向该方向发展。有关演示文稿的建议,请参阅 [presenting.md](https://github.com/tc39/how-we-work/blob/master/presenting.md)

第一阶段更多地表明委员会正在考虑进入此设计领域,而不是就将 JavaScript 朝特定方向发展达成任何共识。

在第一阶段之后(甚至之前),执行以下一些操作可能会很有用:

- **与 JavaScript 开发者讨论**,以了解他们在该领域面临的种种问题,以及在语言级别上有哪些解决方案可能对他们有帮助。
- 如果在某些方面存在分歧,请**在 GitHub 问题中进行讨论**,并考虑对多种解决方案进行详细分析。
- **编写有关早期建议的解决方案的文档,实施草案,测试**等。
- **在 GitHub 上响应**,回答提出的问题并考虑评论者提出的观点。
- **按照[这些说明](https://github.com/tc39/proposals#onboarding-existing-proposals)将提案仓库移至 tc39 组织中 **
- **在 GitHub 上积极回应**,回答提出的问题并考虑评论者提出的观点。
- **按照[这些说明](https://github.com/tc39/proposals#onboarding-existing-proposals)将提案仓库移至 tc39 组织中**

### 第二阶段

流程文档的准入标准:
入门门槛:

> - 初版规范文字
接受表示:
通过的意义:

> 委员会希望该功能得以开发并最终纳入标准
进入第二阶段
- **制定解决方案的完整初稿**。这些并不一定是所有有关语法或语义问题的最终答案,但应该有一个连贯的初始建议,您对此有一定的信心。应该对解释器进行更新,以记录第二阶段的解决方案。
进入第二阶段:

- **制定解决方案的完整初稿**。这些并不一定是所有有关语法或语义问题的最终答案,但应该有一个连贯的初始建议,你对此有一定的信心。应该对解释器进行更新,以记录第二阶段的解决方案。
- **写初始规范文本**。该文本不需要 100% 完整,但应大致覆盖解决方案的表面。 <!-- TODO:链接到规范编写建议文档 -->
- **准备演示文稿**,概述提案以及委员会为何同意将其纳入标准。

在提案进入第二阶段时,我们已经达成共识,我们希望继续进行类似该提案的工作,最终成为 JavaScript 的标准。

在第二阶段之后(甚至之前),执行以下某些操作可能会很有用:

- **继续与 JavaScript 开发者交谈**,并努力寻求解决方案。
- 如果要研究多个解决方案,争取在第三阶段之前的某个时间(可能在第二阶段之前)将它们**解决掉**
- 在第二阶段中,**具有良好的测试实现**显得尤为重要。这不是阶段过程的要求,但是在进入第三阶段并为提案声明一定的完成度之前从实际使用中获取反馈非常有用。完善文档的过程也是如此。
Expand All @@ -110,46 +127,54 @@

### 第三阶段

流程文档的准入标准:
入门门槛:

> - 完整的规范文本
> - 指定的审核者已经签署同意了当前的规范文本
> - 所有 ECMAScript 编者均已签署当前的规范文本
接受表示:
通过的意义:

> 该解决方案是完整的,并且尚缺实施经验、大量的应用和外部反馈,以进行进一步的工作。
进入第三阶段,

- **尽可能解决有关规范的所有语法和语义问题**。在第三阶段中,设计应尽可能完整。这意味着扩展到 JavaScript 开发者,并尝试使用 Transpiler / polyfills,足以在设计上得出这样的结论。仍然可能存在仅由实施方式回答的��解决问题,例如在无法进行多填充/转译的提案中,或在有关实施效率的问题中。
- **填写规范文本**。规范文本应基于已发生的所有设计讨论,以全部细节描述整个建议。
- **从指定的评论者和编辑那里获得第三阶段的评论**。在 TC39 会议召开前几周,通过电子邮件将审稿人和编辑者的电子邮件发给您,询问您的评论进行得如何,如果您还没有收到回复的话
- **从指定的评论者和编辑那里获得第三阶段的评论**。在 TC39 会议召开前几周,通过电子邮件将审稿人和编辑者的电子邮件发给你,询问你的评论进行得如何,如果你还没有收到回复的话
- **准备演示文稿**,解释提案的详细信息及其依据,要求进入第三阶段。

在第三阶段之后(甚至更早),

- **编写 test262 测试**。这些测试可以合并到第三阶段的提案中。确保包括指示它们是哪个提案的功能标志。编写这些测试的过程通常会暴露规范文本中的错误,并且对于确保实现的一致性非常有用。
- **致力于各种实现**。至关重要的是,在这一点上,弄清所有实现约束很重要。例如,某些设计可能满足第三阶段的要求,但具有使现有 JavaScript 程序变慢的副作用 —— 这可能是不被看好,也不是想要的。即使您没有在每个地方都完成一个实现,与各种 JavaScript 引擎的实现者讨论细节以了解他们对可行和可优化事物的约束对于理解是否需要进一步的更改都是非常有用的。
- **致力于各种实现**。至关重要的是,在这一点上,弄清所有实现约束很重要。例如,某些设计可能满足第三阶段的要求,但具有使现有 JavaScript 程序变慢的副作用 —— 这可能是不被看好,也不是想要的。即使你没有在每个地方都完成一个实现,与各种 JavaScript 引擎的实现者讨论细节以了解他们对可行和可优化事物的约束对于理解是否需要进一步的更改都是非常有用的。
- **将决策传达给更广泛的社区**。理想情况下,此时,已经收集并考虑了广泛的社区反馈,并且不再需要进行进一步的设计辩论。

### 第四阶段

流程文档的准入标准:
入门门槛:

> - 已针对主线使用场景编写了 Test262 验收测试,并将其合并
> - 两个兼容的实现通过了验收测试
> - 在实施方面具有丰富的现场经验,例如由两个独立的 VM 向该提案提供经验
> - 带有集成规范文本的拉取请求已发送到 TC39 / ECMA262
> - 所有 ECMAScript 编者均已对拉取请求进行了签名
接受表示:
通过的意义:

> 新增内容将包含在最快的实用标准修订版中
进行到第四阶段,创建以下内容
进行到第四阶段,创建以下内容:

- **至少有两个符合规范的实现**。要做到两个符合规范的实现,一个努力的好方向是那些支持 Web 浏览器和 Node.js 的 JavaScript [V8](https://v8.dev/)[JavaScriptCore](https://trac.webkit.org/wiki/JavaScriptCore)[SpiderMonkey](https://developer.mozilla.org/zh-CN/docs/Mozilla/Projects/SpiderMonkey) 引擎。这是将实现交付给许多 JavaScript 开发者的好方法,并且它对性能有了约束。如果所有实现都在例如编译器中进行,则委员会可能不会被说服,不会认为该提案有了丰富的实施经验,例如,由于编译器没有实现通常会带来特殊困难的 `eval` 之类的功能。
- **完整 Test262 测试**。如果可能,这些测试应旨在覆盖整个规范。
- **针对主要规范的 PR**。较早的规范文本可能有一些捷径,但这对于最终的 PR 来说是不可接受的。例如,这可能涉及为某些重复的规范算法写出详细信息。早期草稿中出现的编辑者注释应转换为普通注释或被删除。
- **准备演示文稿**,总结积极的实施和测试经验,并要求委员会晋升该提案到第四阶段
- **准备演示文稿**,总结积极的实施和测试经验,并要求委员会推动该提案到第四阶段

提案到达第四阶段后,

- **Archive 提案仓库**。第四阶段的提案将不会有进一步的更改,将来的任何更改都将是针对主要规范的单独提案。
- **确保提供了良好的文档**。理想情况下,您在投标过程的早期就开发了文档。现在,至关重要的是,各个级别的文档都必须具有良好的质量,以供广大 JavaScript 开发者使用。
- **确保提供了良好的文档**。理想情况下,你在投标过程的早期就开发了文档。现在,至关重要的是,各个级别的文档都必须具有良好的质量,以供广大 JavaScript 开发者使用。
- **确保在可能的情况下有条件地使用 polyfills 或 shims**。一旦提案进入第四阶段,则在可行且正确的情况下,请顺应内置的实现。这使开发者可以在不牺牲正确性的情况下,尽可能地受益于原生实现的更好性能。对于 polyfills 或 shims,如果存在已知的错误和偏差,则严格检查原生实现是否有用,而不是仅检查原生实现的存在是很有帮助的。但是,以依赖于修改全局环境的形式进行广泛部署存在兼容性风险,尤其是在提案成为标准之前 —— 使用不内置于运行环境中的 polyfill 可能会有所帮助。

> 如果发现译文存在错误或其他需要改进的地方,欢迎到 [掘金翻译计划](https://github.com/xitu/gold-miner) 对译文进行修改并 PR,也可获得相应奖励积分。文章开头的 **本文永久链接** 即为本文在 GitHub 上的 MarkDown 链接。
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@
- 如果缺少实现,你可以自己动手 [添加一个](https://github.com/tc39/how-we-work/blob/master/implement.md)
- 如果你想给提案提出一些反馈,可以在 GitHub 仓库中创建一个 issue。

警告:第 3 阶段及以下阶段的提案可能会发生重大变化或删除
警告:第 3 阶段及以下阶段的提案可能会发生重大变化或被删除

> 如果发现译文存在错误或其他需要改进的地方,欢迎到 [掘金翻译计划](https://github.com/xitu/gold-miner) 对译文进行修改并 PR,也可获得相应奖励积分。文章开头的 **本文永久链接** 即为本文在 GitHub 上的 MarkDown 链接。
---
Expand Down
Loading

0 comments on commit 9c1a6af

Please sign in to comment.