Clarify backlog instructions and add ideas dir

One of the outcomes of the Pike retrospective to clarification
of the purpose of backlog. It was also mentioned that it would be
useful to have an `ideas` directory that allow people to propose
ideas that need to be freshed out and discussed. The backlog somewhat
filled this purpose but is going to be more specific in the future.

This commit clears up the direction of each location and what purpose
they fill.

Change-Id: Ie07f11e67aef1e03311c430963938fe079bf0fa6
This commit is contained in:
Lance Bragstad 2017-09-18 13:32:12 +00:00
parent e2c6a37428
commit b96e763c0a
3 changed files with 30 additions and 9 deletions

View File

@ -39,6 +39,14 @@ Ongoing:
specs/keystone/ongoing/*
Ideas:
.. toctree::
:glob:
:maxdepth: 1
specs/keystone/ideas/*
keystoneauth
============

View File

@ -2,15 +2,18 @@
Backlog Instructions
====================
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.
implemented. Specifications should only be accepted to backlog if they are
fully detailed and ready to be implemented. The only thing preventing a
backlogged specification from being targetted to a release is the absence of an
owner.
Picking up backlogged work
==========================
The updated review should reflect the new primary assignee. Please maintain
all previous assignees in the list of Other Contributors.
If a specification has been partially implemented, the document in the backlog
will contain information of what has been completed.
If you are interested in implementing a backlogged specification, 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. If a specification has been partially implemented,
the document in the backlog will contain information of what has been
completed.

View File

@ -0,0 +1,10 @@
========
Idea Log
========
This directory should be used to document interesting ideas that still need
some thought. Ideas proposed here do not require all semantics to be completely
thoughtout, like specifications do. Ideas accepted here are not guaranteed to a
release. Ideas that are generally accepted should progress to full
specifications and be targeted to a release. Ideas that are no longer
relevant, or end up losing steam, should be pruned from the directory.