b7f1817902
training-labs repo is retired now[1], this commit removes the reference of it. Depends-On: https://review.opendev.org/c/openstack/training-labs/+/817505 [1] http://lists.openstack.org/pipermail/openstack-discuss/2021-October/025586.html Change-Id: I21ec3dde83a1c11b9611b3cc1df6c3f0d14d5cae
84 lines
2.7 KiB
ReStructuredText
84 lines
2.7 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, Contributor Guide, Security Guide, Training Guides, Training Labs
|
|
|
|
- `Docs cores <https://review.opendev.org/#/admin/groups/30,members>`_
|
|
and separate core teams for `docs-specs <https://review.opendev.org/#/admin/groups/384,members>`_
|
|
, `contributor-guide <https://review.opendev.org/#/admin/groups/1841,members>`_
|
|
, `security-doc <https://review.opendev.org/#/admin/groups/347,members>`_
|
|
, and `training-guides <https://review.opendev.org/#/admin/groups/360,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://opendev.org/openstack/heat/>`_
|
|
|
|
- `Developer documentation <https://docs.openstack.org/heat/>`_
|
|
is published from doc directory in master branch
|
|
- `Installation Tutorial (Ocata) <https://docs.openstack.org/project-install-guide/orchestration/ocata/>`_
|
|
is published from install-guide directory in stable/ocata branch
|
|
|
|
Bug reports
|
|
===========
|
|
|
|
- https://bugs.launchpad.net/openstack-manuals
|
|
- https://bugs.launchpad.net/openstack-api-site
|
|
- https://bugs.launchpad.net/openstack-training-guides
|
|
- https://storyboard.openstack.org/#!/project/913
|
|
|
|
Contributor guide
|
|
=================
|
|
|
|
- https://docs.openstack.org/doc-contrib-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/doc-contrib-guide/docs-builds.html
|
|
|
|
EOL documents
|
|
=============
|
|
|
|
- EOL documents are not maintained in the documentation repositories,
|
|
the content is frozen, but published documents are accessible by
|
|
`retention policy <http://specs.openstack.org/openstack/docs-specs/specs/queens/retention-policy.html>`_
|
|
|
|
- See EOL status at: https://releases.openstack.org
|