diff --git a/doc/upstream-training/source/slides/docs.rst b/doc/upstream-training/source/slides/docs.rst new file mode 100644 index 00000000..57a77a9c --- /dev/null +++ b/doc/upstream-training/source/slides/docs.rst @@ -0,0 +1,66 @@ +======================= +OpenStack Documentation +======================= + +.. image:: ./_assets/os_background.png + :class: fill + :width: 100% + +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 +===== + +- http://docs.openstack.org +- http://developer.openstack.org + +Specialty teams +=============== + +- API +- Configuration Reference and CLI Reference +- High Availability Guide +- Hypervisor Tuning Guide +- Installation guides +- Networking Guide +- Operations and Architecture Design guides +- Security Guide +- Training guides +- Training labs +- User guides + +Repositories +============ + +- ``docs-specs`` +- ``openstack-doc-tools`` +- ``openstack-manuals`` +- ``openstackdocstheme`` +- ``security-doc`` +- ``training-guides`` +- ``training-labs`` + +Bug reports +=========== + +- https://bugs.launchpad.net/openstack-manuals +- https://bugs.launchpad.net/openstack-api-site + +Contributor guide +================= + +- http://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 +====================== + +- http://docs.openstack.org/contributor-guide/docs-builds.html diff --git a/doc/upstream-training/source/slides/slide-index.rst b/doc/upstream-training/source/slides/slide-index.rst index 248c4c2d..00a95daa 100644 --- a/doc/upstream-training/source/slides/slide-index.rst +++ b/doc/upstream-training/source/slides/slide-index.rst @@ -56,6 +56,15 @@ Code Deep Dive code-exercises.rst branching-model.rst +Documentation Deep Dive +======================= + +.. toctree:: + :maxdepth: 1 + + + docs.rst + Archive ======= diff --git a/doc/upstream-training/source/website/index.rst b/doc/upstream-training/source/website/index.rst index 388f584c..1138bffb 100644 --- a/doc/upstream-training/source/website/index.rst +++ b/doc/upstream-training/source/website/index.rst @@ -134,6 +134,11 @@ Code Deep Dive * `Demo environment `_ * `Code exercises `_ +Other +----------------------- + +* `Documentation Deep Dive `_ + Archive of additional training activities -----------------------------------------