openstack/glance
Code Issues Proposed changes

Update spec-lite info in contributors' docs

Browse Source 
In Queens, we've begun putting lite specs into their own
individual files instead of all combined into a single file.
This patch changes the contributor docs to reflect this.

Depends-on: I85b096fc0c99a70e3ad0d7f8727b7d5ab679c95b
Change-Id: I94bc4cb3d73d22b06aa923dd29c64208da6a3477
This commit is contained in:
Brian Rosmaita 2017-10-02 10:02:32 -04:00
parent 2562da28c6
commit e6769aba8e
1 changed files with 10 additions and 27 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
doc/source/contributor/blueprints.rst
View File

@ -41,37 +41,20 @@ resources available and cycle priorities.
Glance Spec Lite Glance Spec Lite
---------------- ----------------
In Mitaka the team introduced the concept of lite specs. Lite specs In addition to the heavy-duty design documents described above, we've made a
are small features tracked as Launchpad bugs, with status `wishlist` provision for lightweight design documents for developers who have an idea for
and tagged with the new 'spec-lite' tag, and allow for the submission a small, uncontroversial change. In such a case, you can propose a *spec
and review of these feature requests before code is submitted. lite*, which is a quick description of what you want to do.
This allows for small features that don't warrant a detailed spec to You propose a spec-lite in the same way you propose a full spec: copy
be proposed, evaluated, and worked on. The team evaluates these the `spec-lite template
requests as it evaluates specs. Once a bug has been approved as a <http://git.openstack.org/cgit/openstack/glance-specs/tree/specs/spec-lite-template.rst>`_
Request for Enhancement (RFE), it'll be targeted for a release. in the **approved** directory for the release cycle in which you're proposing
the change, fill out the appropriate sections, and put up a patch in gerrit.
In Newton the team refined lite specs process away from wishlist bugs
and lite specs are hosted in the glance-specs repository in git.
Dedicated lite-specs.rst is provided for each deliverable under the
release.
For example Newton glance_store spec lite file can be found from:
glance-specs/specs/newton/approved/glance_store/lite-specs.rst
This file includes template section and new lite-specs should be
included to the same file under the template. So do not copy the lite-
specs.rst to a new file like you would do with full spec, but just
propose change to that file itself filling the parts of the template
you need.
Existing WISHLIST 'spec-lite' tagged bug will be honored as lite spec,
new ones will not be considered unless filed in glance-spec repo.
Lite spec Submission Guidelines Lite spec Submission Guidelines
------------------------------- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Before we dive into the guidelines for writing a good lite spec, it is Before we dive into the guidelines for writing a good lite spec, it is
worth mentioning that depending on your level of engagement with the worth mentioning that depending on your level of engagement with the