From e7ccb6529200041647dc2e3722e3503ac1552289 Mon Sep 17 00:00:00 2001 From: Adam Young Date: Tue, 7 Oct 2014 14:19:48 -0400 Subject: [PATCH] Backlog The backlog performs two essential functions: 1. It provides a way for a user to float an idea before committing to a detailed analysis. It is, instead, a way for a user to get approval on an approach or design. 2. It is a parking lot for specifications that are orphaned. If a spec is not going to be implemented by the assigned user, it will be collected into the backlog, and be available for other developers to implement. Co-Authored-By: Steve Martinelli Change-Id: If546724fd535db7753a372389c3f90f3b060d9bc --- README.rst | 14 ++++++++++++++ doc/source/index.rst | 11 +++++++++++ specs/backlog/README.rst | 11 +++++++++++ 3 files changed, 36 insertions(+) create mode 100644 specs/backlog/README.rst diff --git a/README.rst b/README.rst index 638a2370..f6f917b1 100644 --- a/README.rst +++ b/README.rst @@ -21,6 +21,20 @@ moved to a directory specific to that release:: You can find an example spec in ``specs/template.rst``. +For specifications that have been reviewed and approved but have not been +implemented:: + + specs/backlog/ + +Specifications in this directory indicate the original author has either +become unavailable, or has indicated that they are not going to implement the +specification. The specifications found here are available as projects for +people looking to get involved with Keystone. If you are interested in +claiming a spec, start by posting a review for the specification that moves it +from this directory to the next active release. Please set yourself as the new +`primary assignee` and maintain the original author in the `other contributors` +list. + Specifications are proposed for a given release by adding them to the ``specs/`` directory and posting it for review. Not all approved blueprints will get fully implemented. The implementation status of a blueprint diff --git a/doc/source/index.rst b/doc/source/index.rst index 70d7f0d0..3a2ccb0c 100644 --- a/doc/source/index.rst +++ b/doc/source/index.rst @@ -56,6 +56,16 @@ Keystone middleware approved specs: specs/keystonemiddleware/* +Untargeted Specifications +========================= + +.. toctree:: + :glob: + :maxdepth: 1 + + specs/backlog/* + + Implemented Specifications ========================== @@ -65,6 +75,7 @@ Implemented Specifications implemented + ================== Indices and tables ================== diff --git a/specs/backlog/README.rst b/specs/backlog/README.rst new file mode 100644 index 00000000..1b71fc3f --- /dev/null +++ b/specs/backlog/README.rst @@ -0,0 +1,11 @@ +======= +Backlog +======= + + +This directory is for specifications that have been approved but not yet +implemented. If you are interested in implementing one of these specifications +submit a review request moving it to the appropriate release. + +The updated review should reflect the new primary assignee. Please maintain +all previous assignees in the list of Other Contributors.