diff options
author | Noemi Wagner <noemi.wagner@nokia.com> | 2019-05-10 15:16:47 +0200 |
---|---|---|
committer | Gergely Csatari <gergely.csatari@nokia.com> | 2019-05-14 15:33:02 +0200 |
commit | 72e5f82a617784ee9515020759d0378e9bd6c92c (patch) | |
tree | c807d3fba5d9cf8bb74a8047f5301f94463cb2c3 | |
parent | 234718a1d9f0338ff465c3c9eeba26e074272dd8 (diff) |
Structural changes to documentation
Link corrected in landing page to the overview document.
We moved out from the Developers Guide: Architecture, Developing ONAP, Setting-up ONAP.
We renamed 'Developing ONAP' section to 'ONAP components and functionalities'. (Later
we plan to further improve the current content of the Developing ONAP section, that is,
we e.g. plan to move 'Documentation' part to Developers Guide).
We are not 100% sure that 'ARchitecture'/'Setting up ONAP'/'ONAP components and functionalities'
(current Developing ONAP) shall be 'duplicated or not, that is, shall be visible on
the left bar AND under Developers Guide as well, OR only in the left bar.
Issue-ID: DOC-449
Change-Id: Idca0bacac3c7cb28a870a7ea5f8beb54fda0187c
Signed-off-by: Noemi Wagner <noemi.wagner@nokia.com>
-rw-r--r-- | docs/guides/onap-developer/developing/index.rst | 4 | ||||
-rw-r--r-- | docs/guides/onap-developer/index.rst | 5 | ||||
-rw-r--r-- | docs/guides/overview/index.rst | 4 | ||||
-rw-r--r-- | docs/index.rst | 66 |
4 files changed, 41 insertions, 38 deletions
diff --git a/docs/guides/onap-developer/developing/index.rst b/docs/guides/onap-developer/developing/index.rst index d481933dc..13a1e21ca 100644 --- a/docs/guides/onap-developer/developing/index.rst +++ b/docs/guides/onap-developer/developing/index.rst @@ -7,8 +7,8 @@ .. _doc_onap-developer_guide_projects: -Developing ONAP -=============== +ONAP components and functionalities +=================================== Additional developer level detail is provided for each project below. Active and Available Inventory diff --git a/docs/guides/onap-developer/index.rst b/docs/guides/onap-developer/index.rst index 011cc57b0..221f7ca0d 100644 --- a/docs/guides/onap-developer/index.rst +++ b/docs/guides/onap-developer/index.rst @@ -7,15 +7,12 @@ Developer Guides ================ The following guides are provided for developers who want to -understanding or contribute to the ONAP open source. +understand or contribute to the ONAP open source. .. toctree:: :maxdepth: 1 - architecture/index tutorials/index - settingup/index - developing/index how-to-use-docs/index apiref/index diff --git a/docs/guides/overview/index.rst b/docs/guides/overview/index.rst index 403c3980e..2b1c4bed8 100644 --- a/docs/guides/overview/index.rst +++ b/docs/guides/overview/index.rst @@ -6,7 +6,9 @@ .. index:: Overview ONAP Overview -========================================= +============= + +.. _overview: .. toctree:: :maxdepth: 2 diff --git a/docs/index.rst b/docs/index.rst index 5ff62a719..04eff2246 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -20,37 +20,40 @@ any product could on its own. Please find some guidance here on the content of the Dublin Release documentation for ONAP: - +---------------------------------------------------------------+-----------------------------------------------------------------------------------------------+ - | Main documentation areas | Description | - +===============================================================+===============================================================================================+ - | :ref:`ONAP Overview <getting-started>` | ONAP Overview provides generic and high-level guidance on the mission and main | - | | functionalities of ONAP. Basic guidelines on license details, limitations and | - | | security references support understanding the solution. | - +---------------------------------------------------------------+-----------------------------------------------------------------------------------------------+ - | :ref:`ONAP Architecture <ONAP-architecture>` | The ONAP architecture and its functional elements are described in details | - | | here. We can learn how the two main frameworks, namely the Design-time | - | | framework and the Run-time framework cooperate and how the Microservices, | - | | Common services and the ONAP Portal support the certain functions. | - +---------------------------------------------------------------+-----------------------------------------------------------------------------------------------+ - | :ref:`Setting Up ONAP <installing-onap>` | Installation guidelines and requirements help the very first set up of an | - | | ONAP environment. The ONAP Operations Manager Cloud setup Guide and the | - | | ONAP Operations Manager Quick Start Guide support the deployment and installation activities. | - +---------------------------------------------------------------+-----------------------------------------------------------------------------------------------+ - | :ref:`Developer Guides <ONAP_developer_guides>` | Developers contributing to the ONAP development can find crucial information | - | | in the Developer Guides. The reader can search among the developers’ topics | - | | in alphabetical order. | - +---------------------------------------------------------------+-----------------------------------------------------------------------------------------------+ - | :ref:`User Guides <user-guides>` | The User Guides provide details on the ONAP portal, which portal integrates | - | | numerous different ONAP applications at one place. Platform operations are | - | | supported with ONAP Operations Quick Start Guide and with an ONAP Operations | - | | User Guide. The instantiation and the management of resources and the services | - | | are supported with a Service Design Guide and with guidelines on Service Deployment. | - +---------------------------------------------------------------+-----------------------------------------------------------------------------------------------+ - | :ref:`VNF and PNF Requirements and Guidelines <vnf_pnf_reqs>` | Harmonized VNF and PNF requirements and reduced customization of onboarding VNFs | - | | and PNFs can accelerate the optimal usage of this ONAP environment. The guidelines | - | | on VNF and PNF requirements facilitates synchronized and aligned activities for all | - | | participants. | - +---------------------------------------------------------------+-----------------------------------------------------------------------------------------------+ + +---------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------+ + | Main documentation areas | Description | + +=================================================================================+===============================================================================================+ + | :ref:`ONAP Overview <overview>` | ONAP Overview provides generic and high-level guidance on the mission and main | + | | functionalities of ONAP. Basic guidelines on license details, limitations and | + | | security references support understanding the solution. | + +---------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------+ + | :ref:`ONAP Architecture <ONAP-architecture>` | The ONAP architecture and its functional elements are described in details | + | | here. We can learn how the two main frameworks, namely the Design-time | + | | framework and the Run-time framework cooperate and how the Microservices, | + | | Common services and the ONAP Portal support the certain functions. | + +---------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------+ + | :ref:`ONAP components and functionalities <doc_onap-developer_guide_projects>` | The ONAP components and functionalities are described in details here. | + | | We can learn what functionalities ONAP provides and how the certain components in ONAP | + | | operate together. | + +---------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------+ + | :ref:`Setting Up ONAP <installing-onap>` | Installation guidelines and requirements help the very first set up of an | + | | ONAP environment. The ONAP Operations Manager Cloud setup Guide and the | + | | ONAP Operations Manager Quick Start Guide support the deployment and installation activities. | + +---------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------+ + | :ref:`Developer Guides <ONAP_developer_guides>` | Developers contributing to the ONAP development can find crucial information | + | | in the Developer Guides. The reader can search among the developers’ topics | + | | in alphabetical order. | + +---------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------+ + | :ref:`User Guides <user-guides>` | The User Guides provide details on the ONAP portal, which portal integrates | + | | numerous different ONAP applications at one place. Platform operations are | + | | supported with ONAP Operations Quick Start Guide and with an ONAP Operations | + | | User Guide. The instantiation and the management of resources and the services | + | | are supported with a Service Design Guide and with guidelines on Service Deployment. | + +---------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------+ + | :ref:`VNF/PNF Requirements and Guidelines <vnf_reqs>` | Harmonized VNF and PNF requirements and reduced customization of onboarding VNFs | + | | and PNFs can accelerate the optimal usage of this ONAP environment. The guidelines | + | | on VNF/PNF requirements facilitates synchronized and aligned activities for all participants. | + +---------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------+ You can reach the complete set of Dublin Release documentation from the Navigation bar on the left. @@ -62,6 +65,7 @@ You can reach the complete set of Dublin Release documentation from the Navigati guides/overview/index release/index guides/onap-developer/architecture/index + guides/onap-developer/developing/index guides/onap-developer/settingup/index guides/onap-developer/index guides/onap-user/index |