Skip to content

Elaborate on motivation in template#3801

Merged
fmease merged 1 commit into
rust-lang:masterfrom
Noratrieb:update-template-motivation
Apr 21, 2025
Merged

Elaborate on motivation in template#3801
fmease merged 1 commit into
rust-lang:masterfrom
Noratrieb:update-template-motivation

Conversation

@Noratrieb

Copy link
Copy Markdown
Member

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.

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.
@Noratrieb Noratrieb added the not-rfc For PRs that fix things like spelling mistakes, wrong file names, etc. label Apr 20, 2025
@fmease

fmease commented Apr 21, 2025

Copy link
Copy Markdown
Member

This is a clear improvement, thanks Nora :)
It should be uncontroversial for me to merge this PR I think, so let's do it

@fmease fmease merged commit 3a35580 into rust-lang:master Apr 21, 2025
@Noratrieb Noratrieb deleted the update-template-motivation branch April 21, 2025 15:25
@steffahn steffahn mentioned this pull request Jul 4, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

not-rfc For PRs that fix things like spelling mistakes, wrong file names, etc.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants