refstack/specs
Martin Kopec 5eb0e719fc Reflect osf/ to openinfra/ namespace rename
Lately osf/ namespace got renamed to openinfra/ [1], this commit
reflects this change within refstack's repo.

[1] https://review.opendev.org/c/openstack/project-config/+/808479

Change-Id: Id8ff246faf19ac67ed6c9dc5ab2514c4655a0610
2021-10-21 22:35:42 +00:00
..
mitaka/implemented Fix specs format to improve rendered documentation 2016-08-10 22:35:00 +00:00
newton/implemented Reflect osf/ to openinfra/ namespace rename 2021-10-21 22:35:42 +00:00
ocata/implemented Rename review.openstack.org to review.opendev.org 2019-07-25 07:41:39 +08:00
pike/approved Fix broken links and redirects 2021-01-08 21:17:29 +00:00
prior Reflect osf/ to openinfra/ namespace rename 2021-10-21 22:35:42 +00:00
queens/approved Reflect osf/ to openinfra/ namespace rename 2021-10-21 22:35:42 +00:00
README.rst Re-organize the RefStack specs directory. 2015-12-08 11:16:47 -08:00
template.rst Fix broken links and redirects 2021-01-08 21:17:29 +00:00

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>/implemented

The 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/refstack

For more information about working with gerrit, see:

http://docs.openstack.org/infra/manual/developers.html#development-workflow

To validate that the specification is syntactically correct (i.e. get more confidence in the Jenkins result), please execute the following command:

$ tox