From 1847e627ee6b2e94892721f0af4fa0af4d0e785f Mon Sep 17 00:00:00 2001 From: Tal Gitelman Date: Wed, 11 Oct 2017 11:31:26 +0300 Subject: Setup Read The Docs for SDC Change-Id: I5bf67b7bb881cebf2ba8fedf1ab69a12889453e2 Issue-ID: SDC-419 Signed-off-by: Tal Gitelman --- docs/index.rst | 10 ++++--- ...templates-platform-component-administration.rst | 19 +++++++++++++ ...s-templates-platform-component-architecture.rst | 7 +++++ ...-templates-platform-component-configuration.rst | 19 +++++++++++++ ...s-templates-platform-component-consumedapis.rst | 8 ++++++ .../docs-templates-platform-component-delivery.rst | 31 +++++++++++++++++++++ ...emplates-platform-component-humaninterfaces.rst | 19 +++++++++++++ .../docs-templates-platform-component-index.rst | 20 ++++++++++++++ ...s-templates-platform-component-installation.rst | 14 ++++++++++ .../docs-templates-platform-component-logging.rst | 14 ++++++++++ ...cs-templates-platform-component-offeredapis.rst | 29 ++++++++++++++++++++ .../docs-templates-release-notes-bug-fixes.rst | 5 ++++ ...s-templates-release-notes-deprecation-notes.rst | 5 ++++ .../docs-templates-release-notes-index.rst | 15 ++++++++++ .../docs-templates-release-notes-known-issues.rst | 5 ++++ .../docs-templates-release-notes-new-features.rst | 5 ++++ .../docs-templates-release-notes-other.rst | 5 ++++ ...ocs-templates-release-notes-security-issues.rst | 5 ++++ .../docs-templates-release-notes-upgrade-notes.rst | 5 ++++ docs/releases/index.rst | 32 ++++++++++++++++++++++ 20 files changed, 268 insertions(+), 4 deletions(-) create mode 100644 docs/onap-developer/docs-templates-platform-component-administration.rst create mode 100644 docs/onap-developer/docs-templates-platform-component-architecture.rst create mode 100644 docs/onap-developer/docs-templates-platform-component-configuration.rst create mode 100644 docs/onap-developer/docs-templates-platform-component-consumedapis.rst create mode 100644 docs/onap-developer/docs-templates-platform-component-delivery.rst create mode 100644 docs/onap-developer/docs-templates-platform-component-humaninterfaces.rst create mode 100644 docs/onap-developer/docs-templates-platform-component-index.rst create mode 100644 docs/onap-developer/docs-templates-platform-component-installation.rst create mode 100644 docs/onap-developer/docs-templates-platform-component-logging.rst create mode 100644 docs/onap-developer/docs-templates-platform-component-offeredapis.rst create mode 100644 docs/releases/docs-templates-release-notes-bug-fixes.rst create mode 100644 docs/releases/docs-templates-release-notes-deprecation-notes.rst create mode 100644 docs/releases/docs-templates-release-notes-index.rst create mode 100644 docs/releases/docs-templates-release-notes-known-issues.rst create mode 100644 docs/releases/docs-templates-release-notes-new-features.rst create mode 100644 docs/releases/docs-templates-release-notes-other.rst create mode 100644 docs/releases/docs-templates-release-notes-security-issues.rst create mode 100644 docs/releases/docs-templates-release-notes-upgrade-notes.rst create mode 100644 docs/releases/index.rst (limited to 'docs') diff --git a/docs/index.rst b/docs/index.rst index 833e1aa969..b4ceb80ea6 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -1,8 +1,10 @@ .. This work is licensed under a Creative Commons Attribution 4.0 International License. -TODO Add files to toctree and delete this header ------------------------------------------------- -.. toctree:: - :maxdepth: 1 +SDC Documentation +================= +.. toctree:: + :maxdepth: 2 + releases/index + onap-developer/index diff --git a/docs/onap-developer/docs-templates-platform-component-administration.rst b/docs/onap-developer/docs-templates-platform-component-administration.rst new file mode 100644 index 0000000000..1d512cf020 --- /dev/null +++ b/docs/onap-developer/docs-templates-platform-component-administration.rst @@ -0,0 +1,19 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 + + +Administration +-------------- +Describe expected changes and the processes and actions taken for each. + + +Processes ++++++++++ +* Process 1 +* Process 2 + +Actions ++++++++ +* Action X +* Action Y + diff --git a/docs/onap-developer/docs-templates-platform-component-architecture.rst b/docs/onap-developer/docs-templates-platform-component-architecture.rst new file mode 100644 index 0000000000..fd46637fd1 --- /dev/null +++ b/docs/onap-developer/docs-templates-platform-component-architecture.rst @@ -0,0 +1,7 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 + + +Architecture +------------ +Describe the architecture and design of the platform component. diff --git a/docs/onap-developer/docs-templates-platform-component-configuration.rst b/docs/onap-developer/docs-templates-platform-component-configuration.rst new file mode 100644 index 0000000000..c0c969f854 --- /dev/null +++ b/docs/onap-developer/docs-templates-platform-component-configuration.rst @@ -0,0 +1,19 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 + +Configuration +------------- +Describe configurations how to provide parameters and value + +Basic Setup ++++++++++++ + +You can provide the following in ``basic.conf`` + +``host=ADDRESS`` + The address of the host + +``port=PORT`` + The port used for signaling + + Optional. Default: ``8080`` diff --git a/docs/onap-developer/docs-templates-platform-component-consumedapis.rst b/docs/onap-developer/docs-templates-platform-component-consumedapis.rst new file mode 100644 index 0000000000..c4309cdb12 --- /dev/null +++ b/docs/onap-developer/docs-templates-platform-component-consumedapis.rst @@ -0,0 +1,8 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 + +Consumed APIs +============= +References to APIs offered by other components + + diff --git a/docs/onap-developer/docs-templates-platform-component-delivery.rst b/docs/onap-developer/docs-templates-platform-component-delivery.rst new file mode 100644 index 0000000000..cfcab0449b --- /dev/null +++ b/docs/onap-developer/docs-templates-platform-component-delivery.rst @@ -0,0 +1,31 @@ +Delivery +-------- +Describe how functions are packaged into run-time components. +For some components a block diagram may be useful. + +.. blockdiag:: + + + blockdiag layers { + orientation = portrait + a -> m; + b -> n; + c -> x; + m -> y; + m -> z; + group l1 { + color = blue; + x; y; z; + } + group l2 { + color = yellow; + m; n; + } + group l3 { + color = orange; + a; b; c; + } + + } + + diff --git a/docs/onap-developer/docs-templates-platform-component-humaninterfaces.rst b/docs/onap-developer/docs-templates-platform-component-humaninterfaces.rst new file mode 100644 index 0000000000..03cc875edf --- /dev/null +++ b/docs/onap-developer/docs-templates-platform-component-humaninterfaces.rst @@ -0,0 +1,19 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 + +Human Interfaces +---------------- +Provide info on the targeted user, interface types, ports/protocols to access, etc. + +Target Users +++++++++++++ + +Interface Type +++++++++++++++ + +Access +++++++ + + + + diff --git a/docs/onap-developer/docs-templates-platform-component-index.rst b/docs/onap-developer/docs-templates-platform-component-index.rst new file mode 100644 index 0000000000..d5db511f1e --- /dev/null +++ b/docs/onap-developer/docs-templates-platform-component-index.rst @@ -0,0 +1,20 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 + +Platform Component +================== +Provide an overview of the ONAP Platform component capabilities here. +Add or remove sections below as appropriate for the platform component. + +.. toctree:: + :maxdepth: 1 + + architecture.rst + offeredapis.rst + consumedapis.rst + delivery.rst + logging.rst + installation.rst + configuration.rst + administration.rst + humaninterfaces.rst diff --git a/docs/onap-developer/docs-templates-platform-component-installation.rst b/docs/onap-developer/docs-templates-platform-component-installation.rst new file mode 100644 index 0000000000..3238236c43 --- /dev/null +++ b/docs/onap-developer/docs-templates-platform-component-installation.rst @@ -0,0 +1,14 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 + +Installation +------------ +Describe the environment and steps to install. + + +Environment ++++++++++++ + + +Steps ++++++ diff --git a/docs/onap-developer/docs-templates-platform-component-logging.rst b/docs/onap-developer/docs-templates-platform-component-logging.rst new file mode 100644 index 0000000000..8d480e2832 --- /dev/null +++ b/docs/onap-developer/docs-templates-platform-component-logging.rst @@ -0,0 +1,14 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 + +Logging & Diagnostic Information +-------------------------------- +Description of how to interact with and diagnose problems with the components +as delivered. + +Where to Access Information ++++++++++++++++++++++++++++ + + +Error / Warning Messages +++++++++++++++++++++++++ diff --git a/docs/onap-developer/docs-templates-platform-component-offeredapis.rst b/docs/onap-developer/docs-templates-platform-component-offeredapis.rst new file mode 100644 index 0000000000..55e58bd9b3 --- /dev/null +++ b/docs/onap-developer/docs-templates-platform-component-offeredapis.rst @@ -0,0 +1,29 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 + + +Offered APIs +============ +List APIs offered. One or more of the following examples may be appropriate. + +Example Swagger Displayed with swaggerv2doc directive +----------------------------------------------------- + +.. swaggerv2doc:: https://gerrit.onap.org/r/gitweb?p=vfc/nfvo/lcm.git;a=blob_plain;f=lcm/swagger/vfc.nslcm.swagger.json + + +Example documenting a REST interface with Sphinx httpdomain directive +--------------------------------------------------------------------- + +.. http:get:: path + + For more information see ``_ + + +Word Document Converted to RST using Pandocs +-------------------------------------------- + +.. toctree:: + :maxdepth: 1 + + ../../submodules/appc.git/docs/APPC API Guide/APPC API Guide diff --git a/docs/releases/docs-templates-release-notes-bug-fixes.rst b/docs/releases/docs-templates-release-notes-bug-fixes.rst new file mode 100644 index 0000000000..ee4ff9faf2 --- /dev/null +++ b/docs/releases/docs-templates-release-notes-bug-fixes.rst @@ -0,0 +1,5 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. + +Bug Fixes +--------- + diff --git a/docs/releases/docs-templates-release-notes-deprecation-notes.rst b/docs/releases/docs-templates-release-notes-deprecation-notes.rst new file mode 100644 index 0000000000..e954e8764c --- /dev/null +++ b/docs/releases/docs-templates-release-notes-deprecation-notes.rst @@ -0,0 +1,5 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. + +Deprecation Notes +----------------- + diff --git a/docs/releases/docs-templates-release-notes-index.rst b/docs/releases/docs-templates-release-notes-index.rst new file mode 100644 index 0000000000..adc76f935c --- /dev/null +++ b/docs/releases/docs-templates-release-notes-index.rst @@ -0,0 +1,15 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. + +Release Notes +============= + +.. toctree:: + :maxdepth: 2 + + new-features.rst + bug-fixes.rst + known-issues.rst + security-issues.rst + upgrade-notes.rst + deprecation-notes.rst + other.rst diff --git a/docs/releases/docs-templates-release-notes-known-issues.rst b/docs/releases/docs-templates-release-notes-known-issues.rst new file mode 100644 index 0000000000..01c93d124a --- /dev/null +++ b/docs/releases/docs-templates-release-notes-known-issues.rst @@ -0,0 +1,5 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. + +Known Issues +------------ + diff --git a/docs/releases/docs-templates-release-notes-new-features.rst b/docs/releases/docs-templates-release-notes-new-features.rst new file mode 100644 index 0000000000..ab86bb9497 --- /dev/null +++ b/docs/releases/docs-templates-release-notes-new-features.rst @@ -0,0 +1,5 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. + +New Features +------------ + diff --git a/docs/releases/docs-templates-release-notes-other.rst b/docs/releases/docs-templates-release-notes-other.rst new file mode 100644 index 0000000000..2ce683b5bf --- /dev/null +++ b/docs/releases/docs-templates-release-notes-other.rst @@ -0,0 +1,5 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. + +Other +----- + diff --git a/docs/releases/docs-templates-release-notes-security-issues.rst b/docs/releases/docs-templates-release-notes-security-issues.rst new file mode 100644 index 0000000000..96e1fe95e0 --- /dev/null +++ b/docs/releases/docs-templates-release-notes-security-issues.rst @@ -0,0 +1,5 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. + +Security Issues +--------------- + diff --git a/docs/releases/docs-templates-release-notes-upgrade-notes.rst b/docs/releases/docs-templates-release-notes-upgrade-notes.rst new file mode 100644 index 0000000000..f31c74a696 --- /dev/null +++ b/docs/releases/docs-templates-release-notes-upgrade-notes.rst @@ -0,0 +1,5 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. + +Upgrade Notes +------------- + diff --git a/docs/releases/index.rst b/docs/releases/index.rst new file mode 100644 index 0000000000..eabde3a24e --- /dev/null +++ b/docs/releases/index.rst @@ -0,0 +1,32 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. + + +Releases +======== +ONAP is developed and released around 6 month cycles. After an initial major release, additional +stable point releases may be created. + +Major Releases +-------------- + +.. csv-table:: + :align: left + :header-rows: 0 + :header: "Release", "Status", "Initial Release Date", "Next Phase", "EOL Date" + :widths: 15, 10, 10, 15, 10 + + "Amsterdam", "Under Development", "TBD", "", "" + "R1.0.0 Seed Code", "EOL", "2017-04-XX", "", "" + + +.. include:: repolist.rst + + +Cryptographic Signatures +------------------------ + + +References +---------- + + -- cgit 1.2.3-korg