78c4ce8ac8
This repository is hosted on opendev.org's gitea server, and doesn't get mirrored to github currently (we may add mirroring in the future). We can swap a bunch of URLs that assume the content is on github and older infra cgit servers with correct URLs. Meetings have moved from IRC to MeetPad, fix the corresponding details in the README. Also use this commit to strip trailing whitespaces across the repository. Change-Id: Ica0a7ba08d9c437f94fbc9ab282bd929f01df8ff
Refstack Specifications
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 folder is as follows:
specs/<release>/
specs/<release>/approved
specs/<release>/implementedThe lifecycle of a specification
Specifications are proposed by adding an .rst file to the
specs/<release>/approved directory and posting it for
review. You can find an example specification in
/specs/template.rst.
Once a specification has been fully implemented, meaning a patch has
landed, it will be moved to the implemented directory and
the corresponding blueprint will be marked as complete.
Specifications are only approved for a single release. If a specification was previously approved but not implemented (or not completely implemented), then the specification needs to be re-proposed by copying (not move) it to the right directory for the current release.
Previously approved specifications
The RefStack specs directory was re-structured during the Mitaka
cycle. Therefore, the specs approved and implemented prior to the Mitaka
cycle will be saved in the specs/prior/ directories.
Others
Please note, Launchpad blueprints are still used for tracking the status of the blueprints. For more information, see:
https://wiki.openstack.org/wiki/Blueprints
https://blueprints.launchpad.net/refstackFor more information about working with gerrit, see:
http://docs.openstack.org/infra/manual/developers.html#development-workflowTo validate that the specification is syntactically correct (i.e. get more confidence in the Jenkins result), please execute the following command:
$ tox