稳定化流程
Rust 语言的新特性和更改通常需要更新参考手册以纳入变更。这可以在稳定化之前的任何时间完成,通常最好尽早准备 PR(前提是实现预计不会发生重大变化)。
此流程的一个例外是,当某个语言更改涉及语言中尚无文档的部分或参考手册中不完整的章节时。例如,类型推断目前没有文档记录,因此对类型推断细节的更改不需要更新参考手册。
然而,当某个新特性引入了一条可以独立于未文档化内容进行陈述的规则时,该规则仍应被记录。在这种情况下,将新规则添加到相关的占位章节中。当该章节最终被填充时,规则将被纳入完整文本。
Pull request
提交 PR 时,请包含尽可能多的信息链接,以便评审者能够更好地理解更改。这包括以下内容的链接(如果存在):
- 跟踪 issue。
rust-lang/rust稳定化 pull request。- 稳定化报告。
- 背景信息,如 RFC。
rustc中实现该特性的文件(如果它被隔离到相对简洁的部分)。rust-lang/rust中的测试。
始终链接到跟踪 issue,以及(如果适用)稳定化 PR。除此之外,已经在跟踪 issue、稳定化报告或 PR 中出现的信息无需在 PR 描述中重复。
内联测试
如果 PR 记录了新稳定化的特性,其内联测试将在稳定化 PR 合并并且新的 nightly 编译器可用之前失败。我们计划在未来改进此流程(参见 #1864)。