nova-specs/doc/source
Eric Fried f1f7a9a154 Tools & docs for backlog & abandoned spec process
Adds tooling and enhances README documentation around the backlog specs
process.

- To move a spec from the backlog to the current release, we can now use
  the ``move-spec`` tox target, e.g.

 tox -e move-spec -- [-n] [-v] specs/backlog/approved/great-idea.rst specs/train/approved

- To abandon a backlog spec - i.e. move it from specs/backlog/approved
  to the (new) specs/abandoned directory, we can now use the
  ``abandon-spec`` tox target, e.g.

 tox -e abandon-spec -- [-n] [-v] specs/backlog/it-was-a-great-idea.rst

These utilities will move the specified spec into the target directory
and create an appropriate redirect for it.

To make it so, this commit factors out a helper method that a) moves a
spec from one subdirectory to another and b) adds a redirect for it.
This is used by the existing ``move-implemented-specs`` utility as well
as the new ``move-spec`` and ``abandon-spec``.

While I was in here, I spruced up the verbose output (including for
move-implemented-specs) to be a bit more readable.

Change-Id: I322eecbacd5dc52accf6ac69c9fe1116be8c216f
2019-04-09 15:23:16 +00:00
..
_images Add 'numa-aware-vswitches' spec 2018-06-05 10:09:32 -04:00
specs Tools & docs for backlog & abandoned spec process 2019-04-09 15:23:16 +00:00
conf.py docs: Resolve issues with Sphinx 2.0 2019-03-29 15:36:14 +00:00
index.rst Tools & docs for backlog & abandoned spec process 2019-04-09 15:23:16 +00:00
priorities Add in concept of project priorities 2014-09-30 17:21:09 -07:00
readme.rst Add readme to docs 2014-08-07 13:30:10 -07:00
redirect.py docs: Resolve issues with Sphinx 2.0 2019-03-29 15:36:14 +00:00

readme.rst