diff options
author | Cédric Ollivier <cedric.ollivier@orange.com> | 2018-11-22 16:24:16 +0100 |
---|---|---|
committer | Cédric Ollivier <cedric.ollivier@orange.com> | 2018-11-22 16:44:46 +0100 |
commit | 1dcfb3ab028bafefa91d91fef627a58480bd89bf (patch) | |
tree | d93226c9effa511445b20ed9ce18c3710935d984 | |
parent | 4c520ec374468937ec2b0e911e23df4577fed90d (diff) |
Check all rst files
It installs doc8 and then checks all rst files.
It also fixes all errors needed for next jjbs.
Change-Id: I30314ece30090ec4923d2c5ad27a9016428102fd
Issue-ID: EXTAPI-163
Signed-off-by: Cédric Ollivier <cedric.ollivier@orange.com>
-rw-r--r-- | docs/administration/administration.rst | 4 | ||||
-rwxr-xr-x | docs/architecture/architecture.rst | 9 | ||||
-rwxr-xr-x | docs/consumedapis/consumedapis.rst | 15 | ||||
-rw-r--r-- | docs/delivery/delivery.rst | 7 | ||||
-rw-r--r-- | docs/humaninterfaces/humaninterfaces.rst | 6 | ||||
-rw-r--r-- | docs/index.rst | 3 | ||||
-rw-r--r-- | docs/installation/installation.rst | 8 | ||||
-rwxr-xr-x | docs/releasenotes/releasenotes.rst | 10 | ||||
-rw-r--r-- | tox.ini | 7 |
9 files changed, 31 insertions, 38 deletions
diff --git a/docs/administration/administration.rst b/docs/administration/administration.rst index 7abffd2..babf452 100644 --- a/docs/administration/administration.rst +++ b/docs/administration/administration.rst @@ -1,5 +1,4 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 International License. -.. http://creativecommons.org/licenses/by/4.0 +.. SPDX-License-Identifier: CC-BY-4.0 .. Copyright 2018 ORANGE @@ -14,4 +13,3 @@ Processes Actions ------- - diff --git a/docs/architecture/architecture.rst b/docs/architecture/architecture.rst index 31f0235..1ded2f6 100755 --- a/docs/architecture/architecture.rst +++ b/docs/architecture/architecture.rst @@ -1,6 +1,4 @@ -.. This work is licensed under -.. a Creative Commons Attribution 4.0 International License. -.. http://creativecommons.org/licenses/by/4.0 +.. SPDX-License-Identifier: CC-BY-4.0 .. Copyright 2018 ORANGE @@ -17,9 +15,9 @@ used by external systems as BSS for example. These API are based on **TMF API**. -******************************************* +********************************************** Global NBI architecture for Casablanca release -******************************************* +********************************************** Following illustration provides a global view about NBI architecture, integration with other ONAP components and API resource/operation provided. @@ -38,4 +36,3 @@ could be found here: :doc:`NBI_Developer_Guide <NBI_Developer_Guide>` API Flow illustration (with example messages) is described in this document: :download:`nbicallflow.pdf <../offeredapis/pdf/nbicallflow.pdf>` - diff --git a/docs/consumedapis/consumedapis.rst b/docs/consumedapis/consumedapis.rst index 38418b3..02b5782 100755 --- a/docs/consumedapis/consumedapis.rst +++ b/docs/consumedapis/consumedapis.rst @@ -1,6 +1,4 @@ -.. This work is licensed under -.. a Creative Commons Attribution 4.0 International License. -.. http://creativecommons.org/licenses/by/4.0 +.. SPDX-License-Identifier: CC-BY-4.0 .. Copyright 2018 ORANGE @@ -57,9 +55,10 @@ SO API ****** This API is used to perform Service Order and thus instantiate a service. -Distinct SO APIs are used for serviceInstance creation request depending on the serviceSpecification category (set in SDC). -If service could be delivered end-to-end from one request category is set to 'E2E Service'. -In this case NBI uses +Distinct SO APIs are used for serviceInstance creation request depending on the +serviceSpecification category (set in SDC). If service could be delivered +end-to-end from one request category is set to 'E2E Service'. +In this case NBI uses :: @@ -69,7 +68,7 @@ In this case NBI uses MSO_DELETE_REQUEST_STATUS_PATH = "/ecomp/mso/infra/serviceInstances/v6/" - + else following API are used: :: @@ -78,4 +77,4 @@ else following API are used: MSO_GET_REQUEST_STATUS_PATH = "/ecomp/mso/infra/orchestrationRequests/v6/" - MSO_DELETE_REQUEST_STATUS_PATH = "/ecomp/mso/infra/serviceInstances/v6/"
\ No newline at end of file + MSO_DELETE_REQUEST_STATUS_PATH = "/ecomp/mso/infra/serviceInstances/v6/" diff --git a/docs/delivery/delivery.rst b/docs/delivery/delivery.rst index 0bbc8c5..6c79228 100644 --- a/docs/delivery/delivery.rst +++ b/docs/delivery/delivery.rst @@ -1,5 +1,4 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 International License. -.. http://creativecommons.org/licenses/by/4.0 +.. SPDX-License-Identifier: CC-BY-4.0 .. Copyright 2018 ORANGE @@ -10,7 +9,8 @@ Delivery NBI Dockers Containers Structure ******************************** -Below is a diagram of the ExternalAPI/NBI project docker containers and the connections between them. +Below is a diagram of the ExternalAPI/NBI project docker containers and the +connections between them. .. blockdiag:: @@ -32,4 +32,3 @@ Below is a diagram of the ExternalAPI/NBI project docker containers and the conn MongoDB; MariaDB; } } - diff --git a/docs/humaninterfaces/humaninterfaces.rst b/docs/humaninterfaces/humaninterfaces.rst index 16f1835..506f1d8 100644 --- a/docs/humaninterfaces/humaninterfaces.rst +++ b/docs/humaninterfaces/humaninterfaces.rst @@ -1,5 +1,4 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 International License. -.. http://creativecommons.org/licenses/by/4.0 +.. SPDX-License-Identifier: CC-BY-4.0 .. Copyright 2018 ORANGE @@ -8,4 +7,5 @@ Human Interfaces no Human Interface (pure Rest API project) -Any "Rest Client" application may be used (Postman, ...) to interact with NBI application. +Any "Rest Client" application may be used (Postman, ...) to interact with NBI +application. diff --git a/docs/index.rst b/docs/index.rst index 5196d1f..f420998 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -1,5 +1,4 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 International License. -.. http://creativecommons.org/licenses/by/4.0 +.. SPDX-License-Identifier: CC-BY-4.0 .. Copyright 2018 Orange ONAP ExternalAPI / NBI diff --git a/docs/installation/installation.rst b/docs/installation/installation.rst index 89a55fb..ebf8c7a 100644 --- a/docs/installation/installation.rst +++ b/docs/installation/installation.rst @@ -1,6 +1,4 @@ -.. This work is licensed under -.. a Creative Commons Attribution 4.0 International License. -.. http://creativecommons.org/licenses/by/4.0 +.. SPDX-License-Identifier: CC-BY-4.0 .. Copyright 2018 ORANGE @@ -41,7 +39,8 @@ Defaults Mongo, host=localhost, port=27017, database=ServiceOrderDB - Mariadb, url=jdbc:mariadb://localhost:3306/nbi, username=root, password=secret + Mariadb, url=jdbc:mariadb://localhost:3306/nbi, username=root, + password=secret Run :: @@ -99,4 +98,3 @@ configuration file and */json/* package with samples requests that can be run. **Play with Postman** A collection is available here *docs/offeredapis/postman* - diff --git a/docs/releasenotes/releasenotes.rst b/docs/releasenotes/releasenotes.rst index 1551e3a..199cc25 100755 --- a/docs/releasenotes/releasenotes.rst +++ b/docs/releasenotes/releasenotes.rst @@ -1,6 +1,4 @@ -.. This work is licensed under a -.. Creative Commons Attribution 4.0 International License. -.. http://creativecommons.org/licenses/by/4.0 +.. SPDX-License-Identifier: CC-BY-4.0 .. Copyright 2018 ORANGE Release Notes @@ -21,7 +19,7 @@ Main features are: - `EXTAPI-101 <https://jira.onap.org/browse/EXTAPI-101>`_ - Integrate ExtAPI/NBI to MSB - `EXTAPI-102 <https://jira.onap.org/browse/EXTAPI-102>`_ - Integrate ExtAPI/NBI to an E2E ONAP UC - `EXTAPI-116 <https://jira.onap.org/browse/EXTAPI-116>`_ - Help NBI user to get information when Service order fails -- `EXTAPI-125 <https://jira.onap.org/browse/EXTAPI-125>`_ - Hadd support for progress percentage on ServiceOrder tracking +- `EXTAPI-125 <https://jira.onap.org/browse/EXTAPI-125>`_ - Add support for progress percentage on ServiceOrder tracking Detail of features described in the readTheDoc documentation. @@ -37,12 +35,10 @@ No new issue (see Beijing ones) **Security Notes** To be completed - + Quick Links: - `External API project page <https://wiki.onap.org/display/DW/External+API+Framework+Project>`_ -- `Passing Badge information for External API <to be completed>`_ -- `Project Vulnerability Review Table for External API <to be completed>`_ **Upgrade Notes** @@ -0,0 +1,7 @@ +[tox] +envlist = docs +skipsdist = True + +[testenv] +deps = doc8 +commands = doc8 docs |