APPC Documentation

Resources for creating ONAP documents

Latest ONAP Documents:

• https://docs.onap.org/

ONAP Documentation Creation:

• http://onap.readthedocs.io/en/latest/guides/onap-developer/how-to-use-docs/index.html

• Readthedocs docs are saved and loaded in rst format.

  • http://docutils.sourceforge.net/rst.html

  • http://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html

Pandoc:

• Used to convert Word documents to rst

• https://pandoc.org

Pandoc – Converting Word Docs to rst

Pandoc installation:

• https://pandoc.org/installing.html

Running pandoc: (note: the embedded image will be created under ./media dir)

Running Pandoc

Testing – Testing rst files using SPHINX

SPHINX (Python Doc Generator)

Sphinx Docs:

• http://www.sphinx-doc.org/en/master

Sphinx and rst:

• http://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html

Install Sphinx:

• http://www.sphinx-doc.org/en/master/usage/installation.html

index.rst

• Must be in the docs root directory

Example index.rst: