infra-specs/README.rst
Doug Hellmann 263c87769e add storyboard link to instructions
Change-Id: I3d46716633ab52af4784edd4387515706cf13200
2015-11-16 16:37:06 +00:00

36 lines
1.3 KiB
ReStructuredText

======================
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.
Expected Work Flow
==================
1. Create a story in StoryBoard_ with a task affecting the
``infra-specs`` project.
2. Propose a change to infra-specs repository (ensure Story:<story
number> is in the commit message).
3. Leave a comment on the story with the Gerrit URL of the
specification.
4. Review happens on proposal by infra-core members and others.
5. When ready for final approval, bring forward the proposed item to
the infra meeting.
Once a specification is approved...
1. Update story, copy summary text of specification to there.
2. 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.
.. _Storyboard: https://storyboard.openstack.org