--- /dev/null
+[submodule "docs/submodules/vnfrqts/guidelines"]
+ path = docs/submodules/vnfrqts/guidelines
+ url = ../vnfrqts/guidelines
# List of patterns, relative to source directory, that match files and
# directories to ignore when looking for source files.
-exclude_patterns = ['_build']
+exclude_patterns = [
+ '_build',
+ 'templates'
+ ]
# The reST default role (used for this markup: `text`) to use for all
# documents.
containing these directories.
when generating documents.
+.. index:: master, document
+
Document Structure and Contribution
-----------------------------------
-A top level structure is proposed for organizing and storing all documents.
+A top level master_document structure is proposed for organizing and storing all documents.
Four areas as shown below with some additional detail under each area.
This structure may change some as we get the full requirements and gain experience with the first reelase of ONAP.
Where multiple sections with similar content are expected, templates can be created and stored
::
docs/
- ├── onap-developer
- │ ├── architecture
- │ ├── develop
- │ ├── test
- │ └── tutorial
├── release
- │ ├── configure
- │ ├── install
│ ├── overview
+ │ ├── architecture
+ │ ├── use-cases
+ │ ├── tutorials
│ └── release-notes
+ ├── onap-developer
+ │ ├── design
+ │ ├── develop
+ │ ├── document
+ │ └── test
+ ├── administrator
+ │ ├── configure
+ │ ├── deploy
+ │ └── operate
├── service-designer
│ ├── deploy
│ ├── design
.. This work is licensed under a Creative Commons Attribution 4.0 International License.
-Documentation Guide
-===================
+Documentation
+=============
.. toctree::
:maxdepth: 2
--- /dev/null
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+
+.. _onap_developer_guide:
+
+ONAP Developer Guide
+====================
+
+.. toctree::
+ :maxdepth: 1
+
+ how-to-use-docs/index
--- /dev/null
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+
+.. _service_designer_guide:
+
+Service Designer Guide
+======================
+
+.. toctree::
+ :maxdepth: 2
+
+More to be added
+----------------
--- /dev/null
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+
+.. _administrator_guide:
+
+Admistrator Guide
+=================
+
+.. toctree::
+ :maxdepth: 2
+
+More to be added
+----------------
--- /dev/null
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+
+.. _vnf_provider_guide:
+
+VNF Provider Guide
+==================
+
+.. toctree::
+ :maxdepth: 2
+
+ ../../submodules/vnfrqts/guidelines/docs/index.rst
.. This work is licensed under a Creative Commons Attribution 4.0 International License.
-Welcome to ONAP documentation!
-================================
+.. _master_index:
-Contents:
+ONAP Documentation
+==================
.. toctree::
:maxdepth: 1
release/index
- how-to-use-docs/index
+ guide/onap-developer/index
+ guide/service-designer/index
+ guide/platform-administrator/index
+ guide/vnf-provider/index
+
+
Indices and tables
==================
* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`
-
Release
=======
-Summary
-=======
-
Overview of use cases, installation, release notes, etc.
+Architecture
+------------
+
+
+Use Cases
+---------
+
+
+Tutorials
+---------
+
+
+Release Notes
+-------------
-Contents:
+Component Specific Notes
+++++++++++++++++++++++++
.. toctree::
:maxdepth: 1
- release-notes/index.rst
+++ /dev/null
-.. This work is licensed under a Creative Commons Attribution 4.0 International License.
-
-==============
-Release Notes
-==============
-
-Release notes as provided by the ONAP project documents are captured in this section.
-These include details of software versions used, known limitations and outstanding trouble
-reports.
-
-Summary
--------
-OpenECOMP 1.0.0 represents a complete demo platform with two
-service examples as contributed by AT&T to the Linux Foundation ONAP project.
-
-Installation Instructions
--------------------------
-
-BasicOpenECOMP installation instructions are available as a `README.md <https://nexus.openecomp.org/content/sites/raw/org.openecomp.demo/heat/1.0.0-SNAPSHOT/README.md>`_ file. Step by step tutorials for setting up a Rackspace account, using the portal, designing services, and instantiating services are provided here.
-
-
-Components
-----------
-
-.. toctree::
- :maxdepth: 1
-
-
--- /dev/null
+Subproject commit 0ac8f52204d571ccd5a98af0e211bd138ceac846