docs(rfc): require issues before RFCs#1918
Open
drew wants to merge 3 commits into
Open
Conversation
Signed-off-by: Drew Newberry <anewberry@nvidia.com>
Signed-off-by: Drew Newberry <anewberry@nvidia.com>
Signed-off-by: Drew Newberry <anewberry@nvidia.com>
TaylorMutch
approved these changes
Jun 15, 2026
pimlock
reviewed
Jun 15, 2026
| ### 2. Get maintainer confirmation | ||
|
|
||
| Look at the existing RFC folders in this directory and choose the next available number. If two authors happen to pick the same number on separate branches, the conflict is resolved during PR review — the later PR simply picks the next available number. | ||
| Maintainers decide from the issue whether an RFC is necessary. If it is, they assign the RFC number in the issue before anyone creates the RFC branch or folder. Authors should use the assigned number instead of choosing one locally. |
Collaborator
There was a problem hiding this comment.
It could be useful if we could filter for issues/PRs that have RFC assigned, should we mention having the issue tagged with rfc once number is assigned?
That's more of a maintainer instruction, so likely belongs somewhere else. Ideally, it should be easy to tell the agent "Assign the next RFC to issue 1234" and it would know what to do (search existing, find the most recent, add one).
pimlock
approved these changes
Jun 15, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Update RFC guidance so users open GitHub issues before RFCs, maintainers request RFCs only when necessary, and maintainers assign RFC numbers from the originating issue. Also correct stale RFC status metadata for existing RFCs.
Related Issue
None.
Changes
accepted, RFC 0001 and RFC 0002 toaccepted, RFC 0003 toimplemented.Testing
mise run pre-commitpassespython:protocould not findgrpc_toolson its first concurrent run,rust:lintcould not buildz3-sysbecausez3.hwas missing, andaws-lc-sysfailed while Homebrew GCC compiled against a macOS SDK header that uses block syntax.git diff --checkpassesmise run markdown:lint:mdpassesChecklist