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 <stevemar@ca.ibm.com>
Change-Id: If546724fd535db7753a372389c3f90f3b060d9bc

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/<release>`` directory and posting it for review.  Not all approved
 blueprints will get fully implemented. The implementation status of a blueprint

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
 ==================

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.