From 71e82bfb508e04eb7836285bbc49022465d4a8ab Mon Sep 17 00:00:00 2001 From: Josh Triplett Date: Tue, 1 Nov 2022 14:46:05 +0100 Subject: [PATCH] Change "how will this" to just "will this" "how will this" comes across as though *every* RFC is about making code easier to maintain. Some RFCs may just be maintenance-neutral. --- 0000-template.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/0000-template.md b/0000-template.md index 85e8ad70..be46af0d 100644 --- a/0000-template.md +++ b/0000-template.md @@ -23,7 +23,7 @@ Explain the proposal as if it was already included in the language and you were - Explaining how Rust programmers should *think* about the feature, and how it should impact the way they use Rust. It should explain the impact as concretely as possible. - If applicable, provide sample error messages, deprecation warnings, or migration guidance. - If applicable, describe the differences between teaching this to existing Rust programmers and new Rust programmers. -- Discuss how this impacts the ability to read, understand, and maintain Rust code. Code is read and modified far more often than written; how will the proposed feature make code easier to maintain? +- Discuss how this impacts the ability to read, understand, and maintain Rust code. Code is read and modified far more often than written; will the proposed feature make code easier to maintain? For implementation-oriented RFCs (e.g. for compiler internals), this section should focus on how compiler contributors should think about the change, and give examples of its concrete impact. For policy RFCs, this section should provide an example-driven introduction to the policy, and explain its impact in concrete terms.