Template should be easier to use with a little more structure between the sections. Added a comment that people can add None instead of deleting a section. This should help keep the use of the template more consistent. The sub-headings in implementation are renamed to match the existing fields in launchpad. Should make parsing these easier at some point in the future. Tweaked the order so its closer to the current launchpad ordering. Partly to ease the transition, party because I like the order they have chosen. Made a distinction between end-users, deployers and developers. This has created much confusion in the past. To reduce the text we force people to delete, trying out adding some instructions as a comment block. Change-Id: I28fae5c03da6939471109de7177ac7d2440e7680
OpenStack Nova Specifications
This git repository is used to hold approved design specifications for additions to the Nova 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:
<release>/
approved/
implemented/Specifications are proposed for a given release by adding it to the approved directory and posting it for review. Once a given spec has been fully implemented in a release, it can be moved to the implemented directory. This provides an easy view of what was actually implemented in a given release. What remains in the approved directory will provide historical record of specs we approved but were not fully implemented.
Specifications have to be re-proposed for every release. The review may be quick, but even if something was previously approved, it should be re-reviewed to make sure it still makes sense as written.
Prior to the Juno development cycle, this repository was not used for spec reviews. Reviews prior to Juno were completed entirely through Launchpad blueprints:
http://blueprints.launchpad.net/novaFor more information about working with gerrit, see:
https://wiki.openstack.org/wiki/Gerrit_Workflow