e2cb246877
Spec describing how branch-specific tasks could be implemented in StoryBoard. Change-Id: Ib02baca0044894712fd5057718b83ca853c53b5d |
||
---|---|---|
doc/source | ||
specs | ||
.coveragerc | ||
.gitignore | ||
.gitreview | ||
.mailmap | ||
.testr.conf | ||
CONTRIBUTING.rst | ||
LICENSE | ||
MANIFEST.in | ||
README.rst | ||
requirements.txt | ||
setup.cfg | ||
setup.py | ||
template.rst | ||
test-requirements.txt | ||
tox.ini |
Infra Specs Repository
This is a git repository for doing design review on enhancements to the OpenStack Project Infrastructure. This provides an ability to ensure that everyone has signed off on the approach to solving a problem early on.
Repository Structure
The expected structure of the respository is as follows:
specs/
implemented/
Expected Work Flow
- Create a story in StoryBoard with a task affecting the
infra-specs
project. - Propose review to infra-specs repository (ensure Story:<story number> is in the commit message).
- Leave a comment with the Gerrit address of the specification.
- Bring forward the proposed item to the infra meeting for summary.
- Review happens on proposal by infra-core members and others.
- Iterate until review is Approved or Rejected.
Once a specification is Approved...
- Update story, copy summary text of specification to there.
- Leave a comment to the git address of the specification.
Revisiting Specifications
We don't always get everything right the first time. If we realize we need to revisit a specification because something changed, either we now know more, or a new idea came in which we should embrace, we'll manage this by proposing an update to the specification in question.
Learn As We Go
This is a new way of attempting things, so we're going to be low in process to begin with to figure out where we go from here. Expect some early flexibility in evolving this effort over time.