From 9c3af50160a00efae37e8a397a046d1c786596f8 Mon Sep 17 00:00:00 2001 From: Rich Bennett Date: Thu, 26 Apr 2018 09:30:57 -0400 Subject: [PATCH] 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 ++++++++++-- .../guides/onap-developer/settingup/components.rst | 4 +-- docs/release/releaserepos.rst | 2 +- docs/validwords.txt | 32 ++++++++++++++++++++++ tox.ini | 9 +++++- 6 files changed, 60 insertions(+), 7 deletions(-) create mode 100644 docs/validwords.txt 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> diff --git a/docs/release/releaserepos.rst b/docs/release/releaserepos.rst index a69a0a507..74fb45d96 100644 --- a/docs/release/releaserepos.rst +++ b/docs/release/releaserepos.rst @@ -79,7 +79,7 @@ Data Management as a Platform Message Router :maxdepth: 1 :titlesonly: - dmaap/messagerouter/messageservice<../submodules/dmaap/messagerouter/messageservice.git/docs/release-notes.rst> + dmaap/messagerouter/messageservice<../submodules/dmaap/messagerouter/messageservice.git/docs/release-notes/release-notes.rst> External API / NBI ------ diff --git a/docs/validwords.txt b/docs/validwords.txt new file mode 100644 index 000000000..b9c90bb10 --- /dev/null +++ b/docs/validwords.txt @@ -0,0 +1,32 @@ +AAF +AAI +Alcatel +amsterdam +Ansible +API +APIs +APPC +ASCII +Avro +BPMN +Camunda +Cask +Cassandra +CCSDK +CD +CDAP +cdrom +ceilometer +Ceilometer +CentOS +Ceph +CI +CLI +Cloudify +committer +committers +CommonMark +Contrail +CPU +CSIT +ONAP diff --git a/tox.ini b/tox.ini index a3520183c..d94b1129b 100644 --- a/tox.ini +++ b/tox.ini @@ -20,6 +20,13 @@ whitelist_externals = echo git -[testenv:docs-linkcheck] +[testenv:linkcheck] deps = -r{toxinidir}/etc/requirements.txt commands = sphinx-build -j 4 -b linkcheck -d {envtmpdir}/doctrees ./docs/ {toxinidir}/docs/_build/linkcheck + +[testenv:spellcheck] +deps = + -r{toxinidir}/etc/requirements.txt + sphinxcontrib-spelling +commands = + sphinx-build -b spelling -Dextensions=sphinxcontrib.spelling -Dspelling_word_list_filename=validwords.txt -d {envtmpdir}/doctrees ./docs/ {toxinidir}/docs/_build/spellcheck -- 2.16.6