Documents in this repo are a collection of ideas. They are not necessarily a formal design for a feature, nor are they docs for a feature, nor are they a roadmap for future features.
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.
The structure of the repository is as follows:
specs/ done/ in_progress/
Implemented specs will be moved to The Done Directory once the associated code has landed.
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.
Naturally you’ll want clarifications about the way a spec is written. To ask questions, propose a patch to the spec (via the normal patch proposal tools) with your question or your understanding of the confusing part. That will raise the issue in a patch review and allow everyone to answer or comment.
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.