Skip to content

Commit 3a35580

Browse files
Noratriebfmease
authored andcommitted
Elaborate on motivation in template
The template had a very short explanation of the motivation, which probably led many people into believing that the motivation can be rather short, compared to the explanations. But really, the motivation is extremely important and should often contain a lot of information. This makes those expectations a lot more explicit. It also explicitly asks for use cases to be listed out, which can then be referenced in the rest of the RFC to make it clearer how it solves the problem.
1 parent 0c497c4 commit 3a35580

File tree

1 file changed

+7
-1
lines changed

1 file changed

+7
-1
lines changed

0000-template.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,13 @@ One paragraph explanation of the feature.
1111
# Motivation
1212
[motivation]: #motivation
1313

14-
Why are we doing this? What use cases does it support? What is the expected outcome?
14+
Any changes to Rust should focus on solving a problem that users of Rust are having.
15+
This section should explain this problem in detail, including necessary background.
16+
17+
It should also contain several specific use cases where this feature can help a user, and explain how it helps.
18+
This can then be used to guide the design of the feature.
19+
20+
This section is one of the most important sections of any RFC, and can be lengthy.
1521

1622
# Guide-level explanation
1723
[guide-level-explanation]: #guide-level-explanation

0 commit comments

Comments
 (0)