c099874423
Documenting this in the contrib guide is important as there is a lot of vendor content coming in. Reference: http://specs.openstack.org/openstack/docs-specs/specs/kilo/move-driver-docs.html Change-Id: I0a67a46a2ddb8eca8b200d02bfbf6c2c550e72e0
25 lines
606 B
ReStructuredText
25 lines
606 B
ReStructuredText
=====================
|
|
Writing documentation
|
|
=====================
|
|
|
|
This chapter describes what documentation contributors should follow
|
|
to ensure consistency throughout all technical publications.
|
|
|
|
You need to understand :doc:`blueprints-and-specs` before you start
|
|
writing. When writing documentation, follow:
|
|
|
|
* :doc:`writing-style`
|
|
* :doc:`rst-conv`
|
|
* :doc:`json-conv`
|
|
|
|
You can :doc:`build your documentation locally <docs-builds>`
|
|
to determine if your change renders properly.
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
topic-structure.rst
|
|
topic-tags.rst
|
|
additional-git-workflow.rst
|
|
vendor-drivers.rst
|