From a3c38919def45d732897aa91533bb0e30e6e3670 Mon Sep 17 00:00:00 2001
From: ShubhamRathi <shubhamiiitbackup@gmail.com>
Date: Sat, 29 Apr 2017 15:56:27 +0530
Subject: 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>
---
 docs/how-to-use-docs/addendum.rst | 79 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 79 insertions(+)
 create mode 100644 docs/how-to-use-docs/addendum.rst

(limited to 'docs/how-to-use-docs/addendum.rst')

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
-- 
cgit 1.2.3-korg