aboutsummaryrefslogtreecommitdiffstats
path: root/0000-template.md
diff options
context:
space:
mode:
authorBryan Newbold <bnewbold@robocracy.org>2018-01-10 21:14:46 -0800
committerBryan Newbold <bnewbold@robocracy.org>2018-01-10 21:14:46 -0800
commita66e7b77d4c3c8ad90022af8bae31094e2bb929b (patch)
treece8e0d7a6b3dec08f3f0b80dc6ce458d89cac6be /0000-template.md
parent9c81ab3e9129c0f462c17ad1c237b87213a68b07 (diff)
downloaddat-deps-a66e7b77d4c3c8ad90022af8bae31094e2bb929b.tar.gz
dat-deps-a66e7b77d4c3c8ad90022af8bae31094e2bb929b.zip
first draft template and DEP-0001
Diffstat (limited to '0000-template.md')
-rw-r--r--0000-template.md59
1 files changed, 59 insertions, 0 deletions
diff --git a/0000-template.md b/0000-template.md
new file mode 100644
index 0000000..1592ade
--- /dev/null
+++ b/0000-template.md
@@ -0,0 +1,59 @@
+
+Title: **DEP 0000: My Proposal**
+
+Short Name: `0000-my-proposal`
+
+Type: (Standard or Process)
+
+Status: Undefined (as of YYYY-MM-DD)
+
+Github PR: (add HTTPS link here after PR is opened)
+
+# 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 DEP 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 DEP that could be addressed in the future independently of the solution that comes out of this DEP?
+
+# Changelog
+[changelog]: #changelog
+
+A brief statemnt about current status can go here, follow by a list of dates
+when the status line of this DEP changed (in most-recent-last order).
+
+- YYYY-MM-DD: First complete draft submitted for review