diff options
author | 2020-12-07 10:34:06 +0000 | |
---|---|---|
committer | 2020-12-07 10:34:06 +0000 | |
commit | ea834dc40eb7bae9f4fd36359f3e20a03044788f (patch) | |
tree | c5b4442294a28ea581d0773ca31fe0b4cd8cc111 | |
parent | b450cf3ec8d89c5a8e21afaf8fe9af4a57f482e7 (diff) | |
parent | 3028409da25aa4dbefc7fe8e30e196753275b27d (diff) |
Merge "Remove remaining warnings during Documentation buildings"
-rw-r--r-- | docs/guides/onap-developer/how-to-use-docs/introduction.rst | 146 | ||||
-rw-r--r-- | docs/guides/onap-developer/how-to-use-docs/setting-up.rst | 59 | ||||
-rw-r--r-- | docs/guides/onap-developer/how-to-use-docs/templates.rst | 2 | ||||
-rw-r--r-- | docs/guides/onap-user/design/resource-onboarding/index.rst | 8 | ||||
-rw-r--r-- | docs/guides/onap-user/design/service-design/index.rst | 10 | ||||
-rw-r--r-- | docs/guides/onap-user/index.rst | 2 | ||||
-rw-r--r-- | docs/release/index.rst | 2 |
7 files changed, 86 insertions, 143 deletions
diff --git a/docs/guides/onap-developer/how-to-use-docs/introduction.rst b/docs/guides/onap-developer/how-to-use-docs/introduction.rst index ceb2eb0e6..250313fc4 100644 --- a/docs/guides/onap-developer/how-to-use-docs/introduction.rst +++ b/docs/guides/onap-developer/how-to-use-docs/introduction.rst @@ -108,81 +108,77 @@ reference parts of source for documentation from other project repositories. Other ONAP projects will provide content that is referenced from this structure. -:: - -docs -├── guides -│ ├── active-projects -│ ├── onap-developer -│ │ ├── apiref -│ │ ├── architecture -│ │ │ └── media -│ │ ├── developing -│ │ ├── how-to-use-docs -│ │ ├── tutorials -│ │ └── use-cases -│ ├── onap-operator -│ │ ├── cloud_site -│ │ │ ├── aws -│ │ │ ├── azure -│ │ │ ├── k8s -│ │ │ ├── openstack -│ │ │ └── vmware -│ │ ├── onap-portal-admin -│ │ │ └── attachments -│ │ └── settingup -│ ├── onap-provider -│ ├── onap-user -│ │ ├── configure -│ │ │ ├── change_config -│ │ │ ├── pnf_connect -│ │ │ └── vnf_connect -│ │ ├── design -│ │ │ ├── control-loop -│ │ │ │ └── media -│ │ │ ├── media -│ │ │ ├── parameter_resolution -│ │ │ │ └── ubuntu_example -│ │ │ │ ├── cba-after-enrichment -│ │ │ │ │ ├── Definitions -│ │ │ │ │ ├── Templates -│ │ │ │ │ └── TOSCA-Metadata -│ │ │ │ ├── cba-before-enrichment -│ │ │ │ │ ├── Definitions -│ │ │ │ │ ├── Templates -│ │ │ │ │ └── TOSCA-Metadata -│ │ │ │ └── ubuntuCDS_heat -│ │ │ ├── pre-onboarding -│ │ │ │ └── media -│ │ │ ├── resource-onboarding -│ │ │ │ └── media -│ │ │ ├── service-design -│ │ │ │ └── media -│ │ │ ├── service-distribution -│ │ │ │ └── media -│ │ │ └── vfcreation -│ │ │ └── media -│ │ ├── instantiate -│ │ │ ├── instantiation -│ │ │ │ ├── nbi -│ │ │ │ ├── pnf_instance -│ │ │ │ ├── service_instance -│ │ │ │ ├── so1 -│ │ │ │ ├── so2 -│ │ │ │ ├── uui -│ │ │ │ ├── vid -│ │ │ │ ├── virtual_link_instance -│ │ │ │ └── vnf_instance -│ │ │ └── pre_instantiation -│ │ └── onap-portal-user -│ │ └── attachments -│ └── overview -│ └── media -├── release -├── templates -│ ├── collections -│ └── sections -└── use-cases +.. code-block:: + + docs + ├── guides + │ ├── onap-developer + │ │ ├── apiref + │ │ ├── architecture + │ │ │ └── media + │ │ ├── developing + │ │ └── how-to-use-docs + | | | ├── templates + │ | | | ├── collections + │ | | | └── sections + │ ├── onap-operator + │ │ ├── cloud_site + │ │ │ ├── aws + │ │ │ ├── azure + │ │ │ ├── k8s + │ │ │ ├── openstack + │ │ │ └── vmware + │ │ ├── onap-portal-admin + │ │ │ └── attachments + │ │ └── settingup + │ ├── onap-provider + │ ├── onap-user + │ │ ├── configure + │ │ │ ├── change_config + │ │ │ ├── pnf_connect + │ │ │ └── vnf_connect + │ │ ├── design + │ │ │ ├── control-loop + │ │ │ │ └── media + │ │ │ ├── media + │ │ │ ├── parameter_resolution + │ │ │ │ └── ubuntu_example + │ │ │ │ ├── cba-after-enrichment + │ │ │ │ │ ├── Definitions + │ │ │ │ │ ├── Templates + │ │ │ │ │ └── TOSCA-Metadata + │ │ │ │ ├── cba-before-enrichment + │ │ │ │ │ ├── Definitions + │ │ │ │ │ ├── Templates + │ │ │ │ │ └── TOSCA-Metadata + │ │ │ │ └── ubuntuCDS_heat + │ │ │ ├── pre-onboarding + │ │ │ │ └── media + │ │ │ ├── resource-onboarding + │ │ │ │ └── media + │ │ │ ├── service-design + │ │ │ │ └── media + │ │ │ ├── service-distribution + │ │ │ │ └── media + │ │ │ └── vfcreation + │ │ │ └── media + │ │ ├── instantiate + │ │ │ ├── instantiation + │ │ │ │ ├── nbi + │ │ │ │ ├── pnf_instance + │ │ │ │ ├── service_instance + │ │ │ │ ├── so1 + │ │ │ │ ├── so2 + │ │ │ │ ├── uui + │ │ │ │ ├── vid + │ │ │ │ ├── virtual_link_instance + │ │ │ │ └── vnf_instance + │ │ │ └── pre_instantiation + │ │ └── onap-portal-user + │ │ └── attachments + │ └── overview + │ └── media + └── release Source Files diff --git a/docs/guides/onap-developer/how-to-use-docs/setting-up.rst b/docs/guides/onap-developer/how-to-use-docs/setting-up.rst index cafa4790a..509e7aff1 100644 --- a/docs/guides/onap-developer/how-to-use-docs/setting-up.rst +++ b/docs/guides/onap-developer/how-to-use-docs/setting-up.rst @@ -332,59 +332,12 @@ for a particular type of project, repository, guide, reference manual, etc. For example, a collection for a platform component, an SDK, etc. You can: browse the template *collections* and *sections* below; -show source to look at the Restructured Text and Sphinx directives used; -copy the source either from a browser window or by downloading the -file in raw form from -the `gerrit doc repository <https://gerrit.onap.org/r/gitweb?p=doc.git;a=tree;f=docs/templates;/>`_ and -then add them to your repository docs folder and index.rst. - +show source to look at the Restructured Text and Sphinx directives used. Sections ++++++++ - -+----------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -|Sections |Description | -+======================================================================================================================+======================================================================================================================================================================================================+ -|`Administration <https://gerrit.onap.org/r/gitweb?p=doc.git;a=blob;f=docs/templates/sections/administration.rst>`_ | This section is used to describe a software component from the perspective of on-going operation including regular processes and actions that are taken to configure and manage the component. | -| | | -+----------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -|`Architecture <https://gerrit.onap.org/r/gitweb?p=doc.git;a=blob;f=docs/templates/sections/architecture.rst>`_ | This section is used to describe a software component from a high level view of capability, common usage scenarios, and interactions with other components required in the usage scenarios. | -| | | -+----------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -|`Build <https://gerrit.onap.org/r/gitweb?p=doc.git;a=blob;f=docs/templates/sections/build.rst>`_ | This section is used to describe how a software component is built from source into something ready for use either in a run-time environment or to build other components. | -| | | -+----------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -|`Configuration <https://gerrit.onap.org/r/gitweb?p=doc.git;a=blob;f=docs/templates/sections/configuration.rst>`_ | This section is used to describe the options a software component offers for configuration. | -| | | -+----------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -|`Consumed APIs <https://gerrit.onap.org/r/gitweb?p=doc.git;a=blob;f=docs/templates/sections/consumedapis.rst>`_ | This section is used to reference APIs that a software component depends on and uses from other sources. | -| | | -+----------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -|`Delivery <https://gerrit.onap.org/r/gitweb?p=doc.git;a=blob;f=docs/templates/sections/delivery.rst>`_ | This section is used to describe a software component packaging. For a run-time component this might be executable images, containers, etc. For an SDK this might be libraries. | -| | | -+----------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -|`Design <https://gerrit.onap.org/r/gitweb?p=doc.git;a=blob;f=docs/templates/sections/design.rst>`_ | This section is used to describe the internal design structure of a software component. | -| | | -+----------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -|`Human interfaces <https://gerrit.onap.org/r/gitweb?p=doc.git;a=blob;f=docs/templates/sections/humaninterfaces.rst>`_ |This section is used to describe a software component's command line and graphical user interfaces. | -| | | -+----------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -|`Installation <https://gerrit.onap.org/r/gitweb?p=doc.git;a=blob;f=docs/templates/sections/installation.rst>`_ | This section is used to describe how a software component is acquired and installed. | -| | | -+----------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -|`Logging <https://gerrit.onap.org/r/gitweb?p=doc.git;a=blob;f=docs/templates/sections/logging.rst>`_ | This section is used to describe the informational or diagnostic messages emitted from a software component and the methods or collecting them. | -| | | -+----------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -|`Offered APIs <https://gerrit.onap.org/r/gitweb?p=doc.git;a=blob;f=docs/templates/sections/offeredapis.rst>`_ | This section is used to describe the external interfaces offered by a software component | -| | | -+----------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -|`Release notes <https://gerrit.onap.org/r/gitweb?p=doc.git;a=blob;f=docs/templates/sections/release-notes.rst>`_ | The release note needs to be updated for each ONAP release | -| | | -+----------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -|`VNF reference <https://gerrit.onap.org/r/gitweb?p=doc.git;a=blob;f=docs/templates/sections/vnf-reference.rst>`_ | This section is used to describe Virtual Network Function software | -| | | -+----------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +Section examples are available here: :ref:`Templates<templates>` Collections +++++++++++ @@ -410,13 +363,7 @@ content that can be used as is or easily converted, and use of Sphinx directives/extensions to automatically generate restructured text from other source you already have. -+------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------+ -|Collections |Description | -+==============================================================================================================================+============================================================+ -|`Platform component <https://gerrit.onap.org/r/gitweb?p=doc.git;a=blob;f=docs/templates/collections/platform-component.rst>`_ | This collection is used to describe a platform component. | -+------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------+ -|`SDK <https://gerrit.onap.org/r/gitweb?p=doc.git;a=blob;f=docs/templates/collections/sdk.rst>`_ | This collection is used to describe an SDK. | -+------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------+ +Collection examples are available here: :ref:`Templates<templates>` Links and References -------------------- diff --git a/docs/guides/onap-developer/how-to-use-docs/templates.rst b/docs/guides/onap-developer/how-to-use-docs/templates.rst index 73b60666b..42dd6ac22 100644 --- a/docs/guides/onap-developer/how-to-use-docs/templates.rst +++ b/docs/guides/onap-developer/how-to-use-docs/templates.rst @@ -2,6 +2,8 @@ .. International License. http://creativecommons.org/licenses/by/4.0 .. Copyright 2020 ONAP community +.. _templates: + Templates ========= diff --git a/docs/guides/onap-user/design/resource-onboarding/index.rst b/docs/guides/onap-user/design/resource-onboarding/index.rst index 2c7020d7d..07fd80a3c 100644 --- a/docs/guides/onap-user/design/resource-onboarding/index.rst +++ b/docs/guides/onap-user/design/resource-onboarding/index.rst @@ -87,7 +87,7 @@ Create a License Key Group [Optional] If required by the resource model, create one or more license key groups; otherwise the license key group is optional. -**Prerequisites:** `Create a License Model`_ +**Prerequisites:** `Create a License Model [Optional]`_ #. Select the License Model in the Onboard section of the SDC. #. In the Overview click the + inside the License Key Groups OR Navigate to License Key Groups and click on “+ ADD LICENSE KEY GROUP” @@ -152,7 +152,7 @@ Create a License Agreement * Select one or more groups in the Available Feature Groups, select one or more feature groups and click on the “>” sign. * Selected feature groups should now be seen under the Selected Feature Groups. #. Click *Save*. -#. Return to step 6 of `Create a License Model`_ to complete the license model. +#. Return to step 6 of `Create a License Model [Optional]`_ to complete the license model. .. _doc_guide_user_des_res-onb_cre-vsp: @@ -167,7 +167,7 @@ for VFs/PNFs. **Prerequisites:** -* `Create a License Model`_ +* `Create a License Model [Optional]`_ * VNF HEAT package or VNF/PNF CSAR/Zip package is available. See :ref:`sdc_onboarding_package_types` for a description @@ -175,7 +175,7 @@ for VFs/PNFs. * If the package is a secure package then :ref:`pre-install the corresponding Root Certificate in SDC <doc_guide_user_des_res-onb_pre-install_root_certificate>`. .. note:: - Example packages can be found in the SDC project: `example-packages`_ + Example packages can be found in the SDC project: :ref:`SDC Packages<onap-sdc:sdc_onboarding_package_types>` #. From the SDC HOME page, click *ONBOARD*. diff --git a/docs/guides/onap-user/design/service-design/index.rst b/docs/guides/onap-user/design/service-design/index.rst index ce7fb9a3c..a1337991e 100644 --- a/docs/guides/onap-user/design/service-design/index.rst +++ b/docs/guides/onap-user/design/service-design/index.rst @@ -93,12 +93,11 @@ Create Service action) - **Management Workflow** model service lifecycle workflows for execution in SO (see `Create a Management Workflow [optional]`_) - - **Network Call Flow** model interactions among VFs (see `Create a - Network Callflow [optional]`_) + - **Network Call Flow** model interactions among VFs (see + `Create a Network Callflow [optional]`_) - **Deployment** view HEAT modules in VSPs - **Properties Assignment** define or update properties, - policies and input parameters used during Service instantiation - (see `Add Service Inputs [optional]`_). + policies and input parameters used during Service instantiation. - **Monitoring** ... #. Click *Check In* to save changes. @@ -284,8 +283,7 @@ updated (see step 4). #. [Optional] Click *Network Callflow* to edit the interactions among VFs that comprise the service (see `Create a Network Callflow [optional]`_). #. [Optional] Click *Properties Assignement* to select parameters as - input fields during Service instantiation - (see `Add Service Inputs [optional]`_). + input fields during Service instantiation. #. Click *Check In* to save changes. #. After updating a service and configuring optional fields, certify it (see `Certify Service`_). diff --git a/docs/guides/onap-user/index.rst b/docs/guides/onap-user/index.rst index d8432fb0a..ee754d266 100644 --- a/docs/guides/onap-user/index.rst +++ b/docs/guides/onap-user/index.rst @@ -27,4 +27,4 @@ In the following page you find all use cases and functional requirements which have been officially verified in the actual release by the ONAP community. * :ref:`Guilin Use Cases<onap-integration:docs_usecases_release>` -* :ref:`Deprecated Use Cases<onap-integration:docs_usecases>` +* :ref:`Deprecated Use Cases<onap-integration:docs_usecases>`
\ No newline at end of file diff --git a/docs/release/index.rst b/docs/release/index.rst index 7c81596c7..10382093a 100644 --- a/docs/release/index.rst +++ b/docs/release/index.rst @@ -186,7 +186,7 @@ Others .. important:: Some non-functional requirements are not fully finalized. Please, check details - on the :ref:`Integration<onap-integration>` + on the :ref:`Integration<onap-integration:release_non_functional_requirements>` Project Specific Release Notes |