openinfra/refstack
Code Issues Proposed changes

Merge "refinment of specs readme."

Browse Source
This commit is contained in:
Jenkins 2014-04-03 21:28:33 +00:00 committed by Gerrit Code Review
commit 4283314189
1 changed files with 6 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
specs/README.rst
View File

@ -2,20 +2,16 @@
Refstack Specifications
==================================
This folder in this repo is used to hold approved design specifications for additions
to the Refstack project. Reviews of the specs are done in gerrit, using a similar
This folder is used to hold design specifications for additions
to the Refstack project. Reviews of the specs are done in gerrit, using a similar
workflow to how we review and merge changes to the code itself.
The layout of this repository is::
Specifications are proposed by adding an .rst file to the `specs/proposed` directory and posting it for review. Not all approved blueprints will get fully implemented. You can find an example spec in `/specs/template.rst`.
specs/specification_name.rst
When a spec has passed the review process and discussions in our weekly meetings it will
be moved to 'specs/approved/'. At that time the blueprint will be marked as approved and assigned to someone.
You can find an example spec in `/specs/template.rst`.
Specifications are proposed for a given release by adding them to the
`specs/` directory and posting it for review. The implementation
status of a blueprint for a given release can be found by looking at the
blueprint in launchpad. Not all approved blueprints will get fully implemented.
Once a spec has been fully implemented, meaning a patch has landed that references the blueprint, it will be moved again to 'specs/completed'.
Prior to April 2014, this method was not used for spec
reviews. Prior reviews were completed entirely through Launchpad