governance/README.rst
Doug Hellmann b4884beda8 clean up readme
Now that the README contents are included on the PyPI page, the phrasing
needs to be updated a little to make them make more sense there.

Change-Id: I170e7567b2101e9eddf5632ac59db79dd07aead8
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
2018-11-30 14:10:20 -05:00

27 lines
1.0 KiB
ReStructuredText

======================
openstack-governance
======================
The repository http://git.openstack.org/cgit/openstack/governance/
contains OpenStack Technical Committee reference documents and tracks
official resolutions voted by the committee. It also contains a
library for accessing some of the machine-readable data in the
repository.
Directory structure:
reference/
Reference documents which need to be revised over time.
Some motions will just directly result in reference doc changes.
resolutions/
When the motion does not result in a change in a reference doc, it
can be expressed as a resolution.
Those must be named YYYYMMDD-short-name with YYYYMMDD being the
proposal date in order to allow basic sorting.
goals/
Documentation for OpenStack community-wide goals, organized by
release cycle. These pages will be updated with project status
info over time, and if goals are revised.
See https://governance.openstack.org/tc/ for details.