From e096c7fb3fd1c43dbf6588ced287ece1db7d1350 Mon Sep 17 00:00:00 2001 From: Trevor Bramwell Date: Tue, 6 Nov 2018 15:30:41 -0800 Subject: Fix minor Documentation Formatting Errors These include wrongly indented bullet points, title underlines, and malfomed links. Templates which are used for project documentation are also excluded from builds as they are orphaned pages. Change-Id: Iaabfb5f2bbf0b9bdfabec622e0b75dd23ea9e472 Signed-off-by: Trevor Bramwell --- docs/how-to-use-docs/documentation-guide.rst | 2 +- docs/how-to-use-docs/include-documentation.rst | 8 ++++++-- 2 files changed, 7 insertions(+), 3 deletions(-) (limited to 'docs/how-to-use-docs') diff --git a/docs/how-to-use-docs/documentation-guide.rst b/docs/how-to-use-docs/documentation-guide.rst index 0f2c3bf02..9315a47b1 100644 --- a/docs/how-to-use-docs/documentation-guide.rst +++ b/docs/how-to-use-docs/documentation-guide.rst @@ -22,7 +22,7 @@ Read :ref:`this page ` which elaborates on how documentat Licencing your documentation ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ All contributions to the OPNFV project are done in accordance with the OPNFV licensing requirements. Documentation in OPNFV is contributed -in accordance with the `Creative Commons 4.0 `_ and the `SPDX https://spdx.org/>`_ licence. +in accordance with the `Creative Commons 4.0 `_ and the `SPDX `_ licence. All documentation files need to be licensed using the text below. The license may be applied in the first lines of all contributed RST files: diff --git a/docs/how-to-use-docs/include-documentation.rst b/docs/how-to-use-docs/include-documentation.rst index d1a5a6227..1798469dc 100644 --- a/docs/how-to-use-docs/include-documentation.rst +++ b/docs/how-to-use-docs/include-documentation.rst @@ -1,4 +1,5 @@ .. _include-documentation: + ============================ Including your Documentation ============================ @@ -229,7 +230,7 @@ specified output folder directory. Adding your project repository as a submodule --------------------------- +--------------------------------------------- Clone the opnfvdocs repository and your submodule to .gitmodules following the convention of the file @@ -244,7 +245,10 @@ Clone the opnfvdocs repository and your submodule to .gitmodules following the c git review Removing a project repository as a submodule --------------------------- +-------------------------------------------- + +.. code-block:: bash + git rm docs/submodules/$reponame rm -rf .git/modules/$reponame git config -f .git/config --remove-section submodule.$reponame 2> /dev/null -- cgit 1.2.3-korg