OPNFV

System Message: WARNING/2 (docs/how-to-use-docs/documentation-example.rst, line 8)

Explicit markup ends without a blank line; unexpected unindent.


System Message: WARNING/2 (docs/how-to-use-docs/documentation-example.rst, line 9)

Line block ends without a blank line.

How to create documentation for your OPNFV project

this is the directory structure of the docs/ directory that can be found in the root of your project directory

./etc
./etc/opnfv-logo.png
./etc/conf.py
./how-to-use-docs
./how-to-use-docs/documentation-example.rst
./how-to-use-docs/index.rst

To create your own documentation, Create any number of directories (depending on your need) and place in each of them an index.rst. This index file must refence your other rst files.

Example Documentation table of contents
=======================================

Contents:

.. toctree::
   :numbered:
   :maxdepth: 4

   documentation-example.rst

Indices and tables
==================

* :ref:`search`

Revision: 4422d1d6812da14497eaa47393899d08909d09b8

Build date: |today|

The Sphinx Build

When you push documentation changes to gerrit a jenkins job will create html documentation.

System Message: WARNING/2 (docs/how-to-use-docs/documentation-example.rst, line 58)

Bullet list ends without a blank line; unexpected unindent.

For verify jobs a link to the documentation will show up as a comment in gerrit for you to see the result.

Once you are happy with the look of your documentation you can submit the patchset the merge job will copy the output of each documentation directory to http://artifacts.opnfv.org/$project/docs/$name_of_your_folder/index.html

Here are some quick examples of how to use rst markup

This is a headline:

here is some code, note that it is indented

links are easy to add: Here is a link to sphinx, the tool that we are using to generate documetation http://sphinx-doc.org/

echo "Heres is a code block with bash syntax highlighting"

Leave these at the bottom of each of your documents they are used internally

Revision: 4422d1d6812da14497eaa47393899d08909d09b8

Build date: |today|

Docutils System Messages

System Message: ERROR/3 (docs/how-to-use-docs/documentation-example.rst, line 86); backlink

Undefined substitution referenced: "today".