This is an old revision of the document!
OPNFV documentation is automated and integrated into our git & gerrit toolchains.
We use RST document templates in our repositories and automatically render to HTML and PDF versions of the documents in our artifact store, our WiKi is also able to integrate these rendered documents directly allowing projects to use the revision controlled documentation process for project information, content and deliverables.
There are some basic steps you will need to perform in order to get the toolchain working in your repository, this include setting up Jenkins jobs and establishing your project documentation structure. See the documents toolchain instructions for more details on getting started in your project. The linked page above is written completely in generated artifacts, check the source to see how to do it yourself!
All documentation for your project should be structured and stored in the <repo>/docs/
directory. The documentation toolchain will look in these directories and be triggered on events in these directories when generating documents.
While many of your documents may be specific to your work there is a general structure proposed for storing and handling documents that are common across many projects. You are encouraged to establish the following basic structure for your project as needed:
Release documentation is the set of documents that are published for each OPNFV release. These documents are created and developed following the OPNFV release process and timelines and should reflect the content of the OPNFV release.
For release documents specific to a project, the documentation should be created in the projects' release directory.
<repo>/docs/release/
Release documents that represent the OPNFV release as a whole have a specific structure and content collation method. These documents have a master index.rst file in the <opnfvdocs>
repository and extract content from other repositories. To provide content into these documents place your <content>.rst files in a directory in your repository that matches the master document and add a reference to that file in the correct place in the master index.rst file in <opnfvdocs>
.
<project dir>/docs/platformoverview
<project dir>/docs/configguide
<project dir>/docs/userguide