summaryrefslogtreecommitdiffstats
path: root/docs/how-to-use-docs/addendum.rst
diff options
context:
space:
mode:
authorShubhamRathi <shubhamiiitbackup@gmail.com>2017-04-29 15:56:27 +0530
committerSofia Wallin <sofia.wallin@ericsson.com>2017-05-04 14:43:58 +0000
commit6d2d247ea230f9fe65d05f98ee1742b4ec39f8b4 (patch)
tree69d19ff4f9f4eb585ec2788cc55275dfc96b90a7 /docs/how-to-use-docs/addendum.rst
parent4f7622c9276a3e03c7bbdbfa6e613d21a9b5166d (diff)
Misc Changes
1. Add sidebar akin to ODL 2. Remove redundant 'OPNFV' from all composite document titles 3. Edit documentation-example for the updated toolchain. Renamed this file as 'addendum.rst'. Eliminated obsolete content. 4. Listed test projects in alphabetic order Change-Id: Ica1c4aa89e3c8f8bcb960fcd4574971960dc52dc Signed-off-by: ShubhamRathi <shubhamiiitbackup@gmail.com> (cherry picked from commit a3c38919def45d732897aa91533bb0e30e6e3670)
Diffstat (limited to 'docs/how-to-use-docs/addendum.rst')
-rw-r--r--docs/how-to-use-docs/addendum.rst79
1 files changed, 79 insertions, 0 deletions
diff --git a/docs/how-to-use-docs/addendum.rst b/docs/how-to-use-docs/addendum.rst
new file mode 100644
index 000000000..d36cd5a15
--- /dev/null
+++ b/docs/how-to-use-docs/addendum.rst
@@ -0,0 +1,79 @@
+========
+Addendum
+========
+
+Index File
+==========
+
+The index file must relatively refence your other rst files in that directory.
+
+Here is an example index.rst :
+
+.. code-block:: bash
+
+ *******************
+ Documentation Title
+ *******************
+
+ .. toctree::
+ :numbered:
+ :maxdepth: 2
+
+ documentation-example
+
+Source Files
+============
+
+Document source files have to be written in reStructuredText format (rst).
+Each file would be build as an html page.
+
+Here is an example source rst file :
+
+.. code-block:: bash
+
+ =============
+ Chapter Title
+ =============
+
+ Section Title
+ =============
+
+ Subsection Title
+ ----------------
+
+ Hello!
+
+Writing RST Markdown
+====================
+
+See http://sphinx-doc.org/rest.html .
+
+**Hint:**
+You can add dedicated contents by using 'only' directive with build type
+('html' and 'singlehtml') for OPNFV document. But, this is not encouraged to
+use since this may make different views.
+
+.. code-block:: bash
+
+ .. only:: html
+ This line will be shown only in html version.
+
+Verify Job
+----------
+
+The verify job name is **docs-verify-rtd-{branch}**.
+
+When you send document changes to gerrit, jenkins will create your documents
+in HTML formats (normal and single-page) to verify that new document can be
+built successfully. Please check the jenkins log and artifact carefully.
+You can improve your document even though if the build job succeeded.
+
+Merge Job
+----------
+
+The merge job name is **docs-merge-rtd-{branch}**.
+
+Once the patch is merged, jenkins will automatically trigger building of
+the new documentation. This might take about 15 minutes while readthedocs
+builds the documentatation. The newly built documentation shall show up
+as appropriate placed in docs.opnfv.org/{branch}/path-to-file. \ No newline at end of file