Update README.rst for better looks

Now that we use gitea, our README.rst is more visble and should be
made a decent entry point to the marvelous world of release management.

This change make it look better, clearer, and updates links.

Change-Id: If331975e16e9d60b9839491354679d9c1a027217
This commit is contained in:
Thierry Carrez 2019-11-13 16:51:02 +01:00
parent 640d8dba89
commit b6149c798a
1 changed files with 29 additions and 18 deletions

View File

@ -1,28 +1,39 @@
=======================
Using This Repository
=======================
====================
OpenStack Releases
====================
All official OpenStack software should go through the
.. image:: https://governance.openstack.org/tc/badges/releases.svg
:target: https://governance.openstack.org/tc/reference/tags/index.html
This repository is used to drive release automation for OpenStack release
deliverables, ultimately publishing them on the https://releases.openstack.org/
website.
Changes to this repository are proposed using Gerrit at
https://review.opendev.org. This repository is managed by the OpenStack
`Release Management team
<https://governance.openstack.org/tc/reference/projects/release-management.html>`_.
For more information on how to use this repository, please read our
`reference documentation <https://releases.openstack.org/#references>`_.
Who should use this repository
------------------------------
All official OpenStack software should go through the OpenStack
`Release Management team
<https://governance.openstack.org/tc/reference/projects/release-management.html>`_
team to produce releases. Exceptions to this rule are granted by
the Technical Committee and documented in the openstack/governance
repository ('release-management' key in reference/projects.yaml).
This repository is used to track release requests. Releases are managed
using groups of "deliverables", made up of individual project repositories
sharing a Launchpad group and a version number history. Many deliverables
will only have one constituent project repository.
The repository is managed by the `Release Management team
<https://governance.openstack.org/tc/reference/projects/release-management.html>`_.
.. image:: https://governance.openstack.org/tc/badges/releases.svg
:target: https://governance.openstack.org/tc/reference/tags/index.html
Refer to `the reference documentation
<https://releases.openstack.org/reference/>`_ for more details
Deliverables managed by teams not under OpenStack governance should
follow the `tagging instructions in the infra manual
<https://docs.openstack.org/infra/manual/drivers.html#tagging-a-release>`__.
More information
----------------
You can reach the Release Management team on the #openstack-release channel
on Freenode IRC, or by sending an email with '[release]' as a subject prefix
to the `openstack-discuss <http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-discuss>`_ mailing-list.