08226f79b6
Change-Id: Id9b39b5b856da9c37cc37e6882fef814af81f540 |
||
---|---|---|
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 |
README.rst
Swift Specs Repository
This is a git repository for doing design review on enhancements to OpenStack Swift. This provides an ability to ensure that everyone has signed off on the approach to solving a problem early on.
Repository Structure
The structure of the repository is as follows:
specs/
done/
in_progress/
Implemented specs will be moved to done-directory
once the associated code has
landed.
The Flow of an Idea from your Head to Implementation
First propose a spec to the in_progress
directory so
that it can be reviewed. Reviewers adding a positive +1/+2 review in
gerrit are promising that they will review the code when it is proposed.
Spec documents should be approved and merged as soon as possible, and
spec documents in the in_progress
directory can be updated
as often as needed. Iterate on it.
- Have an idea
- Propose a spec
- Reviewers review the spec. As soon as 2 core reviewers like something, merge it. Iterate on the spec as often as needed, and keep it updated.
- Once there is agreement on the spec, write the code.
- As the code changes during review, keep the spec updated as needed.
- Once the code lands (with all necessary tests and docs), the spec
can be moved to the
done
directory. If a feature needs a spec, it needs docs, and the docs must land before or with the feature (not after).
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.