aboutsummaryrefslogtreecommitdiff
path: root/proposals/README_template.md
diff options
context:
space:
mode:
authorNick Mathewson <nickm@torproject.org>2020-07-27 10:14:24 -0400
committerNick Mathewson <nickm@torproject.org>2020-07-27 10:42:38 -0400
commit3395172250079bd0c9f20936037b3f9c2c23cc4d (patch)
tree4034662770dcaeca40c7a98d001715e2d2bd3ec8 /proposals/README_template.md
parenta872fc67b425470d0b0a09790dd6a376e4b0515a (diff)
downloadtorspec-3395172250079bd0c9f20936037b3f9c2c23cc4d.tar.gz
torspec-3395172250079bd0c9f20936037b3f9c2c23cc4d.zip
Add a pair of templates for markdown proposal indices
Diffstat (limited to 'proposals/README_template.md')
-rw-r--r--proposals/README_template.md99
1 files changed, 99 insertions, 0 deletions
diff --git a/proposals/README_template.md b/proposals/README_template.md
new file mode 100644
index 0000000..b8fa7e2
--- /dev/null
+++ b/proposals/README_template.md
@@ -0,0 +1,99 @@
+# Tor proposals by status
+
+Here we have a set of proposals for changes to the Tor protocol. Some
+of these proposals are implemented; some are works in progress; and some
+will never be implemented.
+
+Below are a list of proposals sorted by status. See
+[INDEX.md](/proposals/INDEX.md) for a list of proposals sorted by number.
+
+# Active proposals by status
+
+## OPEN proposals: Under discussion
+
+These are proposals that we think are likely to be complete, and ripe
+for discussion.
+
+{OPEN}
+
+## ACCEPTED proposals: Slated for implementation
+
+These are the proposals that we agree we'd like to implement. They
+might or might not have a specific timeframe planned for their
+implementation.
+
+{ACCEPTED}
+
+## FINISHED proposals: Implemented, specs not merged
+
+These proposals are implemented in some version of Tor; the proposals
+themselves still need to be merged into the specifications proper.
+
+{FINISHED}
+
+## META proposals: About the proposal process
+
+These proposals describe ongoing policies and changes to the proposals
+process.
+
+{META}
+
+## INFORMATIONAL proposals: not actually specifications
+
+These proposals describe a process or project, but aren't actually
+proposed changes in the Tor specifications.
+
+{INFORMATIONAL}
+
+# Preliminary proposals
+
+## DRAFT proposals: incomplete works
+
+{DRAFT}
+
+## NEEDS-REVISION proposals: good ideas that we can't implement as-is.
+
+{NEEDS-REVISION}
+
+## NEEDS-RESEARCH proposals: blocking on research
+
+{NEEDS-RESEARCH}
+
+# Inactive proposals by status
+
+## CLOSED proposals: Implemented and specified
+
+These proposals have been implemented in some version of Tor, and the
+changes from the proposals have been merged into the specifications as
+necessary.
+
+{CLOSED}
+
+## RESERVE proposals: Saving for later
+
+These proposals aren't anything we plan to implement soon, but for one
+reason or another we think they might be a good idea in the
+future. We're keeping them around as a reference in case we someday
+confront the problems that they try to solve.
+
+{RESERVE}
+
+## SUPERSEDED proposals: Replaced by something else
+
+These proposals were obsoleted by a later proposal before they were
+implemented.
+
+{SUPERSEDED}
+
+## DEAD, REJECTED, OBSOLETE proposals: Not in our plans.
+
+These proposals are not on-track for discussion or
+implementation. Either discussion has stalled out (the proposal is
+DEAD), the proposal has been considered and not adopted (the proposal is
+REJECTED), or the proposal addresses an issue or a solution that is no
+longer relevant (the proposal is OBSOLETE).
+
+{DEAD_REJECTED_OBSOLETE}
+
+
+