f4b2257293
This patch introduces two new tags to the table: New Developer and Developer. The patch also tags all relevant modules and adds descriptions of the taged groups. Change-Id: I122ac120cbc4ec84db3b3579d75184b393f60987
82 lines
2.5 KiB
ReStructuredText
82 lines
2.5 KiB
ReStructuredText
=======================
|
|
OpenStack Documentation
|
|
=======================
|
|
|
|
.. image:: ./_assets/os_background.png
|
|
:class: fill
|
|
:width: 100%
|
|
|
|
.. note::
|
|
Tags: [operator] [user] [new_dev] [dev]
|
|
|
|
Mission
|
|
=======
|
|
|
|
- Provide documentation for core OpenStack projects to promote OpenStack.
|
|
- Develop and maintain tools and processes to ensure quality, accurate
|
|
documentation.
|
|
- Treat documentation like OpenStack code.
|
|
|
|
Sites
|
|
=====
|
|
|
|
- https://docs.openstack.org
|
|
- https://developer.openstack.org
|
|
|
|
Documentation team structure
|
|
============================
|
|
|
|
- Specialty teams
|
|
|
|
- API, Security Guide, Training Guides, Training Labs
|
|
|
|
- `Docs cores <https://review.openstack.org/#/admin/groups/30,members>`_
|
|
and separate core teams for `docs-specs <https://review.openstack.org/#/admin/groups/384,members>`_
|
|
, `security-doc <https://review.openstack.org/#/admin/groups/347,members>`_
|
|
, `training-guides <https://review.openstack.org/#/admin/groups/360,members>`_
|
|
, and `training-labs <https://review.openstack.org/#/admin/groups/1118,members>`_
|
|
|
|
- `Documentation cross-project liaisons <https://wiki.openstack.org/wiki/CrossProjectLiaisons#Documentation>`_
|
|
for questions, reviews, doc bug triaging, and patching docs
|
|
|
|
Repositories
|
|
============
|
|
|
|
- `Official deliverables with repositories <https://governance.openstack.org/tc/reference/projects/documentation.html#deliverables>`_
|
|
- Project repos have installation tutorials and developer documentation
|
|
|
|
- Example: `Heat repository <https://git.openstack.org/cgit/openstack/heat/tree/>`_
|
|
|
|
- `Installation Tutorial (Ocata) <https://docs.openstack.org/project-install-guide/orchestration/ocata/>`_
|
|
is published from install-guide directory in stable/ocata branch
|
|
- `Developer documentation <https://docs.openstack.org/heat/>`_
|
|
is published from doc directory in master branch
|
|
|
|
Bug reports
|
|
===========
|
|
|
|
- https://bugs.launchpad.net/openstack-manuals
|
|
- https://bugs.launchpad.net/openstack-api-site
|
|
- https://bugs.launchpad.net/openstack-training-guides
|
|
|
|
Contributor guide
|
|
=================
|
|
|
|
- https://docs.openstack.org/contributor-guide/index.html
|
|
|
|
This guide provides detailed instructions on the contribution workflow and
|
|
conventions to be considered by all documentation contributors.
|
|
|
|
Building documentation
|
|
======================
|
|
|
|
- https://docs.openstack.org/contributor-guide/docs-builds.html
|
|
|
|
EOL documents
|
|
=============
|
|
|
|
- EOL documents are not maintained in the documentation repositories,
|
|
the content is frozen.
|
|
|
|
- See EOL status at: https://releases.openstack.org
|