Files
cyborg-specs/README.rst
Ivan Anfimov b4f68b8a51 Remove url tags from README
The tags framework has been discontinued for a long time.

https://governance.openstack.org/tc/reference/tags/

https://governance.openstack.org/tc/resolutions/20211224-tags-framework-removal.html

Change-Id: I581c1a650975109f89e275f15433df6b7c99b777
Signed-off-by: Ivan Anfimov <lazekteam@gmail.com>
2026-02-26 16:49:21 +00:00

1.3 KiB

OpenStack Cyborg Specifications

image

This git repository is used to hold approved design specifications for additions to the Cyborg 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:

specs/<release>/

Where there are two sub-directories:

specs/<release>/approved

specifications approved but not yet implemented

specs/<release>/implemented

implemented specifications

This directory structure allows you to see what we thought about doing, decided to do, and actually got done. Users interested in functionality in a given release should only refer to the implemented directory.

You can find an example spec in doc/source/specs/template.rst.

To track all the blueprints of cyborg, please refer to the launchpad: https://blueprints.launchpad.net/openstack/openstack-cyborg

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

$ tox

After running tox, the documentation will be available for viewing in HTML format in the doc/build/ directory.