From 9c3af50160a00efae37e8a397a046d1c786596f8 Mon Sep 17 00:00:00 2001 From: Rich Bennett Date: Thu, 26 Apr 2018 09:30:57 -0400 Subject: Add tox environment for spellcheck Updates to how-to use documentation for linkcheck and spellcheck Initial list of validword exceptions for immediate use of tox -espellcheck Validword exceptions will be improved when DOC-262 is complete Corrections of RST references based on recent Beijing contributions Change-Id: Ic82de1088fd961c2ad91493e8736777aede1cdb1 Signed-off-by: Rich Bennett Issue-ID: DOC-94 --- docs/guides/onap-developer/apiref/index.rst | 2 +- .../how-to-use-docs/include-documentation.rst | 18 ++++++++++++++++-- docs/guides/onap-developer/settingup/components.rst | 4 ++-- 3 files changed, 19 insertions(+), 5 deletions(-) (limited to 'docs/guides') diff --git a/docs/guides/onap-developer/apiref/index.rst b/docs/guides/onap-developer/apiref/index.rst index 01049c180..34dc24e33 100644 --- a/docs/guides/onap-developer/apiref/index.rst +++ b/docs/guides/onap-developer/apiref/index.rst @@ -47,7 +47,7 @@ Common Services :titlesonly: AAI - Active and Available Inventory <../../../submodules/aai/aai-common.git/docs/AAI REST API Documentation/AAIRESTAPI_AMSTERDAM.rst> - DMaaP - Data Management as a Platform Message Router <../../../submodules/dmaap/messagerouter/messageservice.git/docs/message-router/message-router.rst> + DMaaP - Data Management as a Platform Message Router <../../../submodules/dmaap/messagerouter/messageservice.git/docs/offeredapis/offeredapis.rst> Modeling Parsers <../../../submodules/modeling/toscaparsers.git/docs/offeredapis.rst> MSB - Micro Services Bus <../../../submodules/msb/apigateway.git/docs/platform/offeredapis.rst> MultiVIM Cloud <../../../submodules/multicloud/framework.git/docs/MultiCloud-API-Specification-V1.rst> 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 fb32a3e36..28c7aeb99 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 @@ -205,7 +205,7 @@ About GIT branches ------------------ GIT is a powerful tool allowing many actions, but without respecting some rules -the GIT structure can be quickly ugly and unmaintaible. +the GIT structure can be quickly ugly and unmaintainble. Here are some conventions about GIT branches: - ALWAYS create a local branch to edit or create any file. This local branch @@ -421,7 +421,7 @@ Download the DOC repository. git clone http://gerrit.onap.org/r/doc -Update submodules, build documentation using tox & then open using any browser. +Build documentation using tox local environment & then open using any browser. .. code-block:: bash @@ -430,3 +430,17 @@ Update submodules, build documentation using tox & then open using any browser. firefox docs/_build/html/index.html .. note:: Make sure to run `tox -elocal` and not just `tox`. + +There are additional tox enviornment options for checking External URLs and Spelling. +Use the tox environment options below and then look at the output with the Linux `more` or +similar command for scanning for output that applies to the files you +are validating. + +.. code-block:: bash + + tox -elinkcheck + more < docs/_build/linkcheck/output.txt + + tox -espellcheck + more < docs/_build/spellcheck/output.txt + diff --git a/docs/guides/onap-developer/settingup/components.rst b/docs/guides/onap-developer/settingup/components.rst index ec8b561cf..129a6c048 100644 --- a/docs/guides/onap-developer/settingup/components.rst +++ b/docs/guides/onap-developer/settingup/components.rst @@ -18,7 +18,7 @@ User Interfaces :maxdepth: 1 :titlesonly: - CLAMP - :ref:`Closed Loop Automation Platform` + CLAMP - Closed Loop Automation Platform<../../../submodules/clamp.git/docs/index.rst> SDC - Service Design and Creation <../../../submodules/sdc.git/docs/installation.rst> Use-Case UI <../../../submodules/usecase-ui.git/docs/platform/installation.rst> VID - Virtual Infrastructure Deployment <../../../submodules/vid.git/docs/installation.rst> @@ -30,7 +30,7 @@ Platform Components :maxdepth: 1 :titlesonly: - APPC - Application Controller <../../../submodules/appc/deployment.git/docs/APPC%20Deployment%20Guidelines/APPC%20Deployment%20Guidelines.rst> + APPC - Application Controller <../../../submodules/appc/deployment.git/docs/APPC Deployment Guidelines/APPC Deployment Guidelines.rst> DCAE - Data Collection, Analytics, and Events <../../../submodules/dcaegen2.git/docs/sections/installation.rst> Holmes - Alarm Correlation <../../../submodules/holmes/rule-management.git/docs/platform/installation.rst> Policy <../../../submodules/policy/engine.git/docs/platform/installation.rst> -- cgit 1.2.3-korg