summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorEric Debeau <eric.debeau@orange.com>2019-07-01 18:43:54 +0000
committerGerrit Code Review <gerrit@onap.org>2019-07-01 18:43:54 +0000
commit91e33505a9427b8a8e1bf3eb71b45fe39827da9b (patch)
tree8b9fed74981358de7681d06f3169bb9d69dec627 /docs
parenta6195699515685773228d9635c3fa34bd380c69c (diff)
parentbf4ab4ebfcf6df173db758e29e3c5503f670639d (diff)
Merge "Issue-ID: DOC-493 correcting procedure to test documentation change before submitting the change replacing mv command by cp command mainly"
Diffstat (limited to 'docs')
-rw-r--r--docs/guides/onap-developer/how-to-use-docs/include-documentation.rst24
1 files changed, 16 insertions, 8 deletions
diff --git a/docs/guides/onap-developer/how-to-use-docs/include-documentation.rst b/docs/guides/onap-developer/how-to-use-docs/include-documentation.rst
index 89959914c..6909cceb1 100644
--- a/docs/guides/onap-developer/how-to-use-docs/include-documentation.rst
+++ b/docs/guides/onap-developer/how-to-use-docs/include-documentation.rst
@@ -432,7 +432,12 @@ Install virtual environment.
.. code-block:: bash
sudo pip install virtualenv
- cd /local/repo/path/to/project
+
+Download a project repository.
+
+.. code-block:: bash
+
+ git clone http://gerrit.onap.org/r/<project>
Download the doc repository.
@@ -447,28 +452,31 @@ Change directory to doc & install requirements.
cd doc
sudo pip install -r etc/requirements.txt
-Move the conf.py file to your project folder where RST files have been kept:
+Copy the conf.py file to your project folder where RST files have been kept:
.. code-block:: bash
- mv doc/docs/conf.py <path-to-your-folder>/
+ cp docs/conf.py <path-to-project-folder>/<folder where are rst files>
-Move the static files to your project folder:
+Copy the static files to the project folder where RST files have been kept:
.. code-block:: bash
- mv docs/_static/ <path-to-your-folder>/
+ cp -r docs/_static/ <path-to-project-folder>/<folder where are rst files>
Build the documentation from within your project folder:
.. code-block:: bash
- sphinx-build -b html <path-to-your-folder> <path-to-output-folder>
+ sphinx-build -b html <path-to-project-folder>/<folder where are rst files> <path-to-output-folder>
Your documentation shall be built as HTML inside the
specified output folder directory.
-.. note:: Be sure to remove the `conf.py`, the static/ files and the output folder from the `<project>/docs/`. This is for testing only. Only commit the rst files and related content.
+You can use your Web Browser to open
+and check resulting html pages in the output folder.
+
+.. note:: Be sure to remove the `conf.py`, the static/ files and the output folder from the `<project>/docs/`.This is for testing only. Only commit the rst files and related content.
.. _building-all-documentation:
@@ -502,7 +510,7 @@ Build documentation using tox local environment & then open using any browser.
by the doc project.
There are additional tox environment options for checking External
-URLs and Spelling. Use the tox environment options below and then
+URLs and Spelling. Use the tox environment options below and then
look at the output with the Linux `more` or similar command
scan for output that applies to the files you are validating.