23 lines
864 B
ReStructuredText
23 lines
864 B
ReStructuredText
========================
|
|
Abandoned Specifications
|
|
========================
|
|
|
|
This folder is for specs that were at some point approved, but we have
|
|
since determined, for whatever reason, shall not be implemented.
|
|
|
|
For the time being, let's only use this for backlog specs, and leave
|
|
unchanged the existing process for unimplemented specs in a real
|
|
release (i.e. leave them there in the 'approved' directory).
|
|
|
|
To move a spec to this folder, use the ``abandon-spec`` tox target. In
|
|
addition to moving the file, this ensures the proper redirect is created
|
|
so any existing links in the wild are not broken.
|
|
|
|
For example, first do a dry run (``-n``) with verbose output (``-v``) to
|
|
see what is going to happen::
|
|
|
|
tox -e abandon-spec -- -n -v specs/backlog/approved/it-was-a-great-idea.rst
|
|
|
|
When you are satisfied, remove the ``-n`` option to make it happen for
|
|
real.
|