aboutsummaryrefslogtreecommitdiffstats
path: root/rfcs/template.md
diff options
context:
space:
mode:
Diffstat (limited to 'rfcs/template.md')
-rw-r--r--rfcs/template.md49
1 files changed, 49 insertions, 0 deletions
diff --git a/rfcs/template.md b/rfcs/template.md
new file mode 100644
index 0000000..78fdeb9
--- /dev/null
+++ b/rfcs/template.md
@@ -0,0 +1,49 @@
+
+Status: Undefined (as of YYY-MM-DD)
+
+Type: (Standard or Process)
+
+Github PR: (add HTTPS link here after PR is opened)
+
+Short Name: (number and shortname here, like `0000-my-proposal`)
+
+# Summary
+[summary]: #summary
+
+One paragraph explanation of what this is about.
+
+# Motivation
+[motivation]: #motivation
+
+Why are we doing this? What use cases does it support? What is the expected outcome?
+
+# Usage Documentation
+[usage-documentation]: #usage-documentation
+
+Document new features or processes as if this proposal has already been accepted and implemented. This section should introduce new concepts and terms, describe use cases or situations, and provide examples. If a user-facing feature is added, this should also include user-accessible documentation.
+
+# Reference Documentation
+[reference-documentation]: #reference-documentation
+
+This section is a more formal description of the proposal, written as if it was a sub-section of the standard (for techincal proposals) or a formal process or "fine print" for process proposals.
+
+It should be unambiguous and cover all known corner-cases. Formal language (such as protobuf schemas or binary header diagrams) are appropriate here.
+
+# Drawbacks
+[drawbacks]: #drawbacks
+
+Why should we *not* do this?
+
+# Rationale and alternatives
+[alternatives]: #alternatives
+
+- Why is this design the best in the space of possible designs?
+- What other designs have been considered and what is the rationale for not choosing them?
+- What is the impact of not doing this?
+
+# Unresolved questions
+[unresolved]: #unresolved-questions
+
+- What parts of the design do you expect to resolve through the RFC consensus process before this gets merged?
+- What parts of the design do you expect to resolve through implementation and code review, or are left to independent library or application developers?
+- What related issues do you consider out of scope for this RFC that could be addressed in the future independently of the solution that comes out of this RFC?