From 7881a0541c8b40663bba4aa3a5efdf9f3421e58f Mon Sep 17 00:00:00 2001 From: Sofia Wallin Date: Mon, 16 Jan 2017 16:12:13 +0100 Subject: Adjusted naming path Adjusted the naming path for consistency throughout our repository and the community. Change-Id: Ia055c418584f338f6000835fc28a7e5e8b5c5818 Signed-off-by: Sofia Wallin --- ...//-installation.rst | 22 -------- ...//-postinstallation.rst | 17 ------ .../Templates/Installation//index.rst | 10 ---- docs/release/Templates/Installation/abstract.rst | 6 --- .../Templates/Installation/compatibility.rst | 18 ------- docs/release/Templates/Installation/index.rst | 18 ------- .../Templates/Installation/prerequisite.rst | 15 ------ .../Templates/Installation/supportedscenario.rst | 13 ----- docs/release/Templates/Overview/index.rst | 18 ------- docs/release/Templates/Overview/overview.rst | 13 ----- docs/release/Templates/ReleaseNotes/bugs.rst | 63 ---------------------- .../Templates/ReleaseNotes/compatibility.rst | 18 ------- .../Templates/ReleaseNotes/deliverables.rst | 12 ----- docs/release/Templates/ReleaseNotes/index.rst | 44 --------------- .../release/Templates/ReleaseNotes/newfeatures.rst | 23 -------- docs/release/Templates/ReleaseNotes/references.rst | 5 -- .../ReleaseNotes/scenario/.rst | 37 ------------- .../Templates/ReleaseNotes/scenario/index.rst | 16 ------ docs/release/Templates/ReleaseNotes/version.rst | 13 ----- .../Templates/userguide/feature.userguide.rst | 18 ------- docs/release/Templates/userguide/index.rst | 23 -------- ...//-installation.rst | 22 ++++++++ ...//-postinstallation.rst | 17 ++++++ .../templates/installation//index.rst | 10 ++++ docs/release/templates/installation/abstract.rst | 6 +++ .../templates/installation/compatibility.rst | 18 +++++++ docs/release/templates/installation/index.rst | 18 +++++++ .../templates/installation/prerequisite.rst | 15 ++++++ .../templates/installation/supportedscenario.rst | 13 +++++ docs/release/templates/overview/index.rst | 18 +++++++ docs/release/templates/overview/overview.rst | 13 +++++ docs/release/templates/releasenotes/bugs.rst | 63 ++++++++++++++++++++++ .../templates/releasenotes/compatibility.rst | 18 +++++++ .../templates/releasenotes/deliverables.rst | 12 +++++ docs/release/templates/releasenotes/index.rst | 44 +++++++++++++++ .../release/templates/releasenotes/newfeatures.rst | 23 ++++++++ docs/release/templates/releasenotes/references.rst | 5 ++ .../releasenotes/scenario/.rst | 37 +++++++++++++ .../templates/releasenotes/scenario/index.rst | 16 ++++++ docs/release/templates/releasenotes/version.rst | 13 +++++ .../templates/userguide/feature.userguide.rst | 18 +++++++ docs/release/templates/userguide/index.rst | 23 ++++++++ 42 files changed, 422 insertions(+), 422 deletions(-) delete mode 100644 docs/release/Templates/Installation//-installation.rst delete mode 100644 docs/release/Templates/Installation//-postinstallation.rst delete mode 100644 docs/release/Templates/Installation//index.rst delete mode 100644 docs/release/Templates/Installation/abstract.rst delete mode 100644 docs/release/Templates/Installation/compatibility.rst delete mode 100644 docs/release/Templates/Installation/index.rst delete mode 100644 docs/release/Templates/Installation/prerequisite.rst delete mode 100644 docs/release/Templates/Installation/supportedscenario.rst delete mode 100644 docs/release/Templates/Overview/index.rst delete mode 100644 docs/release/Templates/Overview/overview.rst delete mode 100644 docs/release/Templates/ReleaseNotes/bugs.rst delete mode 100644 docs/release/Templates/ReleaseNotes/compatibility.rst delete mode 100644 docs/release/Templates/ReleaseNotes/deliverables.rst delete mode 100644 docs/release/Templates/ReleaseNotes/index.rst delete mode 100644 docs/release/Templates/ReleaseNotes/newfeatures.rst delete mode 100644 docs/release/Templates/ReleaseNotes/references.rst delete mode 100644 docs/release/Templates/ReleaseNotes/scenario/.rst delete mode 100644 docs/release/Templates/ReleaseNotes/scenario/index.rst delete mode 100644 docs/release/Templates/ReleaseNotes/version.rst delete mode 100644 docs/release/Templates/userguide/feature.userguide.rst delete mode 100644 docs/release/Templates/userguide/index.rst create mode 100644 docs/release/templates/installation//-installation.rst create mode 100644 docs/release/templates/installation//-postinstallation.rst create mode 100644 docs/release/templates/installation//index.rst create mode 100644 docs/release/templates/installation/abstract.rst create mode 100644 docs/release/templates/installation/compatibility.rst create mode 100644 docs/release/templates/installation/index.rst create mode 100644 docs/release/templates/installation/prerequisite.rst create mode 100644 docs/release/templates/installation/supportedscenario.rst create mode 100644 docs/release/templates/overview/index.rst create mode 100644 docs/release/templates/overview/overview.rst create mode 100644 docs/release/templates/releasenotes/bugs.rst create mode 100644 docs/release/templates/releasenotes/compatibility.rst create mode 100644 docs/release/templates/releasenotes/deliverables.rst create mode 100644 docs/release/templates/releasenotes/index.rst create mode 100644 docs/release/templates/releasenotes/newfeatures.rst create mode 100644 docs/release/templates/releasenotes/references.rst create mode 100644 docs/release/templates/releasenotes/scenario/.rst create mode 100644 docs/release/templates/releasenotes/scenario/index.rst create mode 100644 docs/release/templates/releasenotes/version.rst create mode 100644 docs/release/templates/userguide/feature.userguide.rst create mode 100644 docs/release/templates/userguide/index.rst (limited to 'docs/release') diff --git a/docs/release/Templates/Installation//-installation.rst b/docs/release/Templates/Installation//-installation.rst deleted file mode 100644 index a8cef90ba..000000000 --- a/docs/release/Templates/Installation//-installation.rst +++ /dev/null @@ -1,22 +0,0 @@ -============================================= - Installation -============================================= - - -Preparing for Installation -===================================== -Include any pre configuration, database, or other software downloads -required to install . - -Installing -==================================== -Installation toolkit - -Verifying your Installation -==================================== -Describe how to verify the installation. - -Troubleshooting -==================================== - -Text goes here. \ No newline at end of file diff --git a/docs/release/Templates/Installation//-postinstallation.rst b/docs/release/Templates/Installation//-postinstallation.rst deleted file mode 100644 index f60537566..000000000 --- a/docs/release/Templates/Installation//-postinstallation.rst +++ /dev/null @@ -1,17 +0,0 @@ -================================================= - Post Installation -================================================= - - -Post Installation Configuration -===================================== -Post Installation Configuration section must include some basic -(must-do) procedures if any, to get started. - -Upgrading From -==================================== -Text goes here. - -?Uninstalling? -==================================== -Text here. diff --git a/docs/release/Templates/Installation//index.rst b/docs/release/Templates/Installation//index.rst deleted file mode 100644 index 053e341d5..000000000 --- a/docs/release/Templates/Installation//index.rst +++ /dev/null @@ -1,10 +0,0 @@ -=================================== - Installation Guide -=================================== - -.. toctree:: - :maxdepth: 2 - - prerequisite - -installation - -postinstallation \ No newline at end of file diff --git a/docs/release/Templates/Installation/abstract.rst b/docs/release/Templates/Installation/abstract.rst deleted file mode 100644 index 4868b1a2a..000000000 --- a/docs/release/Templates/Installation/abstract.rst +++ /dev/null @@ -1,6 +0,0 @@ -============================================= - Abstract -============================================= -.. Example, Joid Danube Abstract - -Abstract explaining the Document \ No newline at end of file diff --git a/docs/release/Templates/Installation/compatibility.rst b/docs/release/Templates/Installation/compatibility.rst deleted file mode 100644 index ffed03042..000000000 --- a/docs/release/Templates/Installation/compatibility.rst +++ /dev/null @@ -1,18 +0,0 @@ -============================================== - Compatibility -============================================== - - -Compatibility with Previous Releases -======================================= - -Is it compatible? Did anything about how a user or developer would -consume it change? If so, document it here. - -Migration from Previous Releases -===================================== - - -Describe any special step somebody would have to take to migrate from a -previous release to this one. If migration isn't supported for some -combinations, state that as well. \ No newline at end of file diff --git a/docs/release/Templates/Installation/index.rst b/docs/release/Templates/Installation/index.rst deleted file mode 100644 index 032f8d40e..000000000 --- a/docs/release/Templates/Installation/index.rst +++ /dev/null @@ -1,18 +0,0 @@ -=================================== - Installation Guide -=================================== - -Installation Guide -=================== -Refer to https://wiki.opnfv.org/display/DOC/Installation+procedure -Naming Convention is: . Eg: Apex Installation Guide Abstract - -.. toctree:: - :maxdepth: 2 - - abstract - prerequisite - supportedscenario - /index - compatibility - references \ No newline at end of file diff --git a/docs/release/Templates/Installation/prerequisite.rst b/docs/release/Templates/Installation/prerequisite.rst deleted file mode 100644 index 4f8a0069f..000000000 --- a/docs/release/Templates/Installation/prerequisite.rst +++ /dev/null @@ -1,15 +0,0 @@ -============================================= - Prerequisite -============================================= - - -Hardware requirement -===================================== -List out the HW requirements - -Software requirement -==================================== -List out the SW requirements - -Configurations -==================================== \ No newline at end of file diff --git a/docs/release/Templates/Installation/supportedscenario.rst b/docs/release/Templates/Installation/supportedscenario.rst deleted file mode 100644 index 3d78911f1..000000000 --- a/docs/release/Templates/Installation/supportedscenario.rst +++ /dev/null @@ -1,13 +0,0 @@ -=================================================== - Supported Scenarios -=================================================== - - -========= -Add a short brief about supported scenarios - -.. toctree:: - :maxdepth: 2 - - development//index - development//index \ No newline at end of file diff --git a/docs/release/Templates/Overview/index.rst b/docs/release/Templates/Overview/index.rst deleted file mode 100644 index 18e1dbd9d..000000000 --- a/docs/release/Templates/Overview/index.rst +++ /dev/null @@ -1,18 +0,0 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 International -.. License. -.. http://creativecommons.org/licenses/by/4.0 -.. (c) OPNFV, Ericsson AB and others. - -============================================= - Overview -============================================= - -For example, the title might be "Qtip Danube Overview" - - -=================== - -.. toctree:: - :maxdepth: 2 - - overview diff --git a/docs/release/Templates/Overview/overview.rst b/docs/release/Templates/Overview/overview.rst deleted file mode 100644 index 163cdd3e0..000000000 --- a/docs/release/Templates/Overview/overview.rst +++ /dev/null @@ -1,13 +0,0 @@ -============================================== - Overview -============================================== - - -Introduction -======================================= -Describing the components and behaviours in a manner that helps people understand the platform and how to work with it - -Upgrades from -===================================== - -Describe the new features \ No newline at end of file diff --git a/docs/release/Templates/ReleaseNotes/bugs.rst b/docs/release/Templates/ReleaseNotes/bugs.rst deleted file mode 100644 index fbb25dc58..000000000 --- a/docs/release/Templates/ReleaseNotes/bugs.rst +++ /dev/null @@ -1,63 +0,0 @@ -============================================= - Bugs -============================================= - - -Resolved Bugs -=============== -List open and resolved bugs if any. - -**JIRA TICKETS:** - -+--------------------------------------+--------------------------------------+ -| **JIRA REFERENCE** | **SLOGAN** | -| | | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-86 | Need ability to specify number of | -| | compute nodes | -+--------------------------------------+--------------------------------------+ - -Deprecated and Removed Capabilities -===================================== -Provide information about the capabilities that are removed or -deprecated in this release. - -**JIRA TICKETS:** - -+--------------------------------------+--------------------------------------+ -| **JIRA REFERENCE** | **SLOGAN** | -| | | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-86 | Need ability to specify number of | -| | compute nodes | -+--------------------------------------+--------------------------------------+ - -Known Limitations -===================================== -Provide information about the capabilities that are removed or -deprecated in this release. - -**JIRA TICKETS:** - -+--------------------------------------+--------------------------------------+ -| **JIRA REFERENCE** | **SLOGAN** | -| | | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-86 | Need ability to specify number of | -| | compute nodes | -+--------------------------------------+--------------------------------------+ - -Open Bugs -===================================== -List any remaining open bugs. Ideally provide a short description and a -link to the entry in JIRA - -**JIRA TICKETS:** - -+--------------------------------------+--------------------------------------+ -| **JIRA REFERENCE** | **SLOGAN** | -| | | -+--------------------------------------+--------------------------------------+ -| JIRA: APEX-86 | Need ability to specify number of | -| | compute nodes | -+--------------------------------------+--------------------------------------+ \ No newline at end of file diff --git a/docs/release/Templates/ReleaseNotes/compatibility.rst b/docs/release/Templates/ReleaseNotes/compatibility.rst deleted file mode 100644 index ffed03042..000000000 --- a/docs/release/Templates/ReleaseNotes/compatibility.rst +++ /dev/null @@ -1,18 +0,0 @@ -============================================== - Compatibility -============================================== - - -Compatibility with Previous Releases -======================================= - -Is it compatible? Did anything about how a user or developer would -consume it change? If so, document it here. - -Migration from Previous Releases -===================================== - - -Describe any special step somebody would have to take to migrate from a -previous release to this one. If migration isn't supported for some -combinations, state that as well. \ No newline at end of file diff --git a/docs/release/Templates/ReleaseNotes/deliverables.rst b/docs/release/Templates/ReleaseNotes/deliverables.rst deleted file mode 100644 index 25812085a..000000000 --- a/docs/release/Templates/ReleaseNotes/deliverables.rst +++ /dev/null @@ -1,12 +0,0 @@ -============================================== - Deliverables -============================================== - - -Software Deliverables -======================================= -List out the software deliverables - -Documentation Deliverables -===================================== -Call out the documentation deliverables \ No newline at end of file diff --git a/docs/release/Templates/ReleaseNotes/index.rst b/docs/release/Templates/ReleaseNotes/index.rst deleted file mode 100644 index 9530d803d..000000000 --- a/docs/release/Templates/ReleaseNotes/index.rst +++ /dev/null @@ -1,44 +0,0 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 International -.. License. -.. http://creativecommons.org/licenses/by/4.0 -.. (c) OPNFV, Ericsson AB and others. - -============================================= - Release Notes -============================================= - -Abstract -=================== -Preface to what this document is about - -License -======= -Include Licensing information here - -Version History -=============== - - -+-------------+-----------+-----------------+----------------------+ -| **Date** | **Ver.** | **Authors** | **Comment** | -| | | | | -+-------------+-----------+-----------------+----------------------+ -| YYYY-MM-DD | X.X.X | Name | Comments | -+-------------+-----------+-----------------+----------------------+ -| YYYY-MM-DD | X.X.X | Name | Comments |+-------------+-----------+-----------------+----------------------+ -| YYYY-MM-DD | X.X.X | Name | Comments | -+-------------+-----------+-----------------+----------------------+ - -Contents -=============== - -.. toctree:: - :maxdepth: 2 - - summary - version - compatibility - bugs - deliverables - scenario/index - references diff --git a/docs/release/Templates/ReleaseNotes/newfeatures.rst b/docs/release/Templates/ReleaseNotes/newfeatures.rst deleted file mode 100644 index eab36cdca..000000000 --- a/docs/release/Templates/ReleaseNotes/newfeatures.rst +++ /dev/null @@ -1,23 +0,0 @@ -============================================= - New Features -============================================= - - -Major Capabilities and Enhancements -===================================== -Provide information about the major capabilities this project provides -in this release. Include those from previous release unless they have -been deprecated or removed (see below). - -New Capabilities and Enhancements -==================================== -Call out the new capabilities and/or enhancements that are present in -this release, but were not present in prior releases. - - -+--------------------------------------+--------------------------------------+ -| **JIRA REFERENCE** | **SLOGAN** | -| | | -+--------------------------------------+--------------------------------------+ -| JIRA: | Brief here | -+--------------------------------------+--------------------------------------+ diff --git a/docs/release/Templates/ReleaseNotes/references.rst b/docs/release/Templates/ReleaseNotes/references.rst deleted file mode 100644 index 590aeb587..000000000 --- a/docs/release/Templates/ReleaseNotes/references.rst +++ /dev/null @@ -1,5 +0,0 @@ -============================================== - References -============================================== - -List references \ No newline at end of file diff --git a/docs/release/Templates/ReleaseNotes/scenario/.rst b/docs/release/Templates/ReleaseNotes/scenario/.rst deleted file mode 100644 index 47c85ec15..000000000 --- a/docs/release/Templates/ReleaseNotes/scenario/.rst +++ /dev/null @@ -1,37 +0,0 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 International License. -.. http://creativecommons.org/licenses/by/4.0 -.. (c) - - -============================================= - Release Notes -============================================= - - -Introduction -============ -.. In this section explain the purpose of the scenario and the types of capabilities provided - -Scenario components and composition -=================================== -.. In this section describe the unique components that make up the scenario, -.. what each component provides and why it has been included in order -.. to communicate to the user the capabilities available in this scenario. - -Scenario usage overview -======================= -.. Provide a brief overview on how to use the scenario and the features available to the -.. user. This should be an "introduction" to the userguide document, and explicitly link to it, -.. where the specifics of the features are covered including examples and API's - -Limitations, Issues and Workarounds -=================================== -.. Explain scenario limitations here, this should be at a design level rather than discussing -.. faults or bugs. If the system design only provide some expected functionality then provide -.. some insight at this point. - -References -========== - -For more information on the OPNFV Colorado release, please visit -http://www.opnfv.org/colorado \ No newline at end of file diff --git a/docs/release/Templates/ReleaseNotes/scenario/index.rst b/docs/release/Templates/ReleaseNotes/scenario/index.rst deleted file mode 100644 index 7a2cf9bb1..000000000 --- a/docs/release/Templates/ReleaseNotes/scenario/index.rst +++ /dev/null @@ -1,16 +0,0 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 International -.. License. -.. http://creativecommons.org/licenses/by/4.0 -.. (c) OPNFV, Ericsson AB and others. - -============================================= - Scenario Release Notes -============================================= - - -=================== - -.. toctree:: - :maxdepth: 2 - - diff --git a/docs/release/Templates/ReleaseNotes/version.rst b/docs/release/Templates/ReleaseNotes/version.rst deleted file mode 100644 index ba552595a..000000000 --- a/docs/release/Templates/ReleaseNotes/version.rst +++ /dev/null @@ -1,13 +0,0 @@ -============================================== - Version -============================================== - - -Module version changes -======================== -List module level version changes - - -Document Version Changes -========================== -Changes in documentation \ No newline at end of file diff --git a/docs/release/Templates/userguide/feature.userguide.rst b/docs/release/Templates/userguide/feature.userguide.rst deleted file mode 100644 index 517f93d2f..000000000 --- a/docs/release/Templates/userguide/feature.userguide.rst +++ /dev/null @@ -1,18 +0,0 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 International License. -.. http://creativecommons.org/licenses/by/4.0 -.. (c) - - description -===================== -.. Describe the specific features and how it is realised in the scenario in a brief manner -.. to ensure the user understand the context for the user guide instructions to follow. - - capabilities and usage -================================ -.. Describe the specific capabilities and usage for feature. -.. Provide enough information that a user will be able to operate the feature on a deployed scenario. - - ------------------------------------------------ -.. Describe with examples how to use specific features, provide API examples and details required to -.. operate the feature on the platform. diff --git a/docs/release/Templates/userguide/index.rst b/docs/release/Templates/userguide/index.rst deleted file mode 100644 index 820155fdf..000000000 --- a/docs/release/Templates/userguide/index.rst +++ /dev/null @@ -1,23 +0,0 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 International License. -.. http://creativecommons.org/licenses/by/4.0 -.. (c) - -===================== - User Guide -===================== - -.. The feature user guide should provide an OPNFV user with enough information to -.. use the features provided by the feature project in the supported scenarios. -.. This guide should walk a user through the usage of the features once a scenario -.. has been deployed and is active according to the installation guide provided -.. by the installer project. - -.. toctree:: - :maxdepth: 2 - -.. The feature.userguide.rst file should contain the text for this document -.. additional documents can be added to this directory and added in the right order -.. to this file as a list below. - - ./feature.userguide.rst - diff --git a/docs/release/templates/installation//-installation.rst b/docs/release/templates/installation//-installation.rst new file mode 100644 index 000000000..a8cef90ba --- /dev/null +++ b/docs/release/templates/installation//-installation.rst @@ -0,0 +1,22 @@ +============================================= + Installation +============================================= + + +Preparing for Installation +===================================== +Include any pre configuration, database, or other software downloads +required to install . + +Installing +==================================== +Installation toolkit + +Verifying your Installation +==================================== +Describe how to verify the installation. + +Troubleshooting +==================================== + +Text goes here. \ No newline at end of file diff --git a/docs/release/templates/installation//-postinstallation.rst b/docs/release/templates/installation//-postinstallation.rst new file mode 100644 index 000000000..f60537566 --- /dev/null +++ b/docs/release/templates/installation//-postinstallation.rst @@ -0,0 +1,17 @@ +================================================= + Post Installation +================================================= + + +Post Installation Configuration +===================================== +Post Installation Configuration section must include some basic +(must-do) procedures if any, to get started. + +Upgrading From +==================================== +Text goes here. + +?Uninstalling? +==================================== +Text here. diff --git a/docs/release/templates/installation//index.rst b/docs/release/templates/installation//index.rst new file mode 100644 index 000000000..053e341d5 --- /dev/null +++ b/docs/release/templates/installation//index.rst @@ -0,0 +1,10 @@ +=================================== + Installation Guide +=================================== + +.. toctree:: + :maxdepth: 2 + + prerequisite + -installation + -postinstallation \ No newline at end of file diff --git a/docs/release/templates/installation/abstract.rst b/docs/release/templates/installation/abstract.rst new file mode 100644 index 000000000..4868b1a2a --- /dev/null +++ b/docs/release/templates/installation/abstract.rst @@ -0,0 +1,6 @@ +============================================= + Abstract +============================================= +.. Example, Joid Danube Abstract + +Abstract explaining the Document \ No newline at end of file diff --git a/docs/release/templates/installation/compatibility.rst b/docs/release/templates/installation/compatibility.rst new file mode 100644 index 000000000..ffed03042 --- /dev/null +++ b/docs/release/templates/installation/compatibility.rst @@ -0,0 +1,18 @@ +============================================== + Compatibility +============================================== + + +Compatibility with Previous Releases +======================================= + +Is it compatible? Did anything about how a user or developer would +consume it change? If so, document it here. + +Migration from Previous Releases +===================================== + + +Describe any special step somebody would have to take to migrate from a +previous release to this one. If migration isn't supported for some +combinations, state that as well. \ No newline at end of file diff --git a/docs/release/templates/installation/index.rst b/docs/release/templates/installation/index.rst new file mode 100644 index 000000000..032f8d40e --- /dev/null +++ b/docs/release/templates/installation/index.rst @@ -0,0 +1,18 @@ +=================================== + Installation Guide +=================================== + +Installation Guide +=================== +Refer to https://wiki.opnfv.org/display/DOC/Installation+procedure +Naming Convention is: . Eg: Apex Installation Guide Abstract + +.. toctree:: + :maxdepth: 2 + + abstract + prerequisite + supportedscenario + /index + compatibility + references \ No newline at end of file diff --git a/docs/release/templates/installation/prerequisite.rst b/docs/release/templates/installation/prerequisite.rst new file mode 100644 index 000000000..4f8a0069f --- /dev/null +++ b/docs/release/templates/installation/prerequisite.rst @@ -0,0 +1,15 @@ +============================================= + Prerequisite +============================================= + + +Hardware requirement +===================================== +List out the HW requirements + +Software requirement +==================================== +List out the SW requirements + +Configurations +==================================== \ No newline at end of file diff --git a/docs/release/templates/installation/supportedscenario.rst b/docs/release/templates/installation/supportedscenario.rst new file mode 100644 index 000000000..3d78911f1 --- /dev/null +++ b/docs/release/templates/installation/supportedscenario.rst @@ -0,0 +1,13 @@ +=================================================== + Supported Scenarios +=================================================== + + +========= +Add a short brief about supported scenarios + +.. toctree:: + :maxdepth: 2 + + development//index + development//index \ No newline at end of file diff --git a/docs/release/templates/overview/index.rst b/docs/release/templates/overview/index.rst new file mode 100644 index 000000000..18e1dbd9d --- /dev/null +++ b/docs/release/templates/overview/index.rst @@ -0,0 +1,18 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International +.. License. +.. http://creativecommons.org/licenses/by/4.0 +.. (c) OPNFV, Ericsson AB and others. + +============================================= + Overview +============================================= + +For example, the title might be "Qtip Danube Overview" + + +=================== + +.. toctree:: + :maxdepth: 2 + + overview diff --git a/docs/release/templates/overview/overview.rst b/docs/release/templates/overview/overview.rst new file mode 100644 index 000000000..163cdd3e0 --- /dev/null +++ b/docs/release/templates/overview/overview.rst @@ -0,0 +1,13 @@ +============================================== + Overview +============================================== + + +Introduction +======================================= +Describing the components and behaviours in a manner that helps people understand the platform and how to work with it + +Upgrades from +===================================== + +Describe the new features \ No newline at end of file diff --git a/docs/release/templates/releasenotes/bugs.rst b/docs/release/templates/releasenotes/bugs.rst new file mode 100644 index 000000000..fbb25dc58 --- /dev/null +++ b/docs/release/templates/releasenotes/bugs.rst @@ -0,0 +1,63 @@ +============================================= + Bugs +============================================= + + +Resolved Bugs +=============== +List open and resolved bugs if any. + +**JIRA TICKETS:** + ++--------------------------------------+--------------------------------------+ +| **JIRA REFERENCE** | **SLOGAN** | +| | | ++--------------------------------------+--------------------------------------+ +| JIRA: APEX-86 | Need ability to specify number of | +| | compute nodes | ++--------------------------------------+--------------------------------------+ + +Deprecated and Removed Capabilities +===================================== +Provide information about the capabilities that are removed or +deprecated in this release. + +**JIRA TICKETS:** + ++--------------------------------------+--------------------------------------+ +| **JIRA REFERENCE** | **SLOGAN** | +| | | ++--------------------------------------+--------------------------------------+ +| JIRA: APEX-86 | Need ability to specify number of | +| | compute nodes | ++--------------------------------------+--------------------------------------+ + +Known Limitations +===================================== +Provide information about the capabilities that are removed or +deprecated in this release. + +**JIRA TICKETS:** + ++--------------------------------------+--------------------------------------+ +| **JIRA REFERENCE** | **SLOGAN** | +| | | ++--------------------------------------+--------------------------------------+ +| JIRA: APEX-86 | Need ability to specify number of | +| | compute nodes | ++--------------------------------------+--------------------------------------+ + +Open Bugs +===================================== +List any remaining open bugs. Ideally provide a short description and a +link to the entry in JIRA + +**JIRA TICKETS:** + ++--------------------------------------+--------------------------------------+ +| **JIRA REFERENCE** | **SLOGAN** | +| | | ++--------------------------------------+--------------------------------------+ +| JIRA: APEX-86 | Need ability to specify number of | +| | compute nodes | ++--------------------------------------+--------------------------------------+ \ No newline at end of file diff --git a/docs/release/templates/releasenotes/compatibility.rst b/docs/release/templates/releasenotes/compatibility.rst new file mode 100644 index 000000000..ffed03042 --- /dev/null +++ b/docs/release/templates/releasenotes/compatibility.rst @@ -0,0 +1,18 @@ +============================================== + Compatibility +============================================== + + +Compatibility with Previous Releases +======================================= + +Is it compatible? Did anything about how a user or developer would +consume it change? If so, document it here. + +Migration from Previous Releases +===================================== + + +Describe any special step somebody would have to take to migrate from a +previous release to this one. If migration isn't supported for some +combinations, state that as well. \ No newline at end of file diff --git a/docs/release/templates/releasenotes/deliverables.rst b/docs/release/templates/releasenotes/deliverables.rst new file mode 100644 index 000000000..25812085a --- /dev/null +++ b/docs/release/templates/releasenotes/deliverables.rst @@ -0,0 +1,12 @@ +============================================== + Deliverables +============================================== + + +Software Deliverables +======================================= +List out the software deliverables + +Documentation Deliverables +===================================== +Call out the documentation deliverables \ No newline at end of file diff --git a/docs/release/templates/releasenotes/index.rst b/docs/release/templates/releasenotes/index.rst new file mode 100644 index 000000000..9530d803d --- /dev/null +++ b/docs/release/templates/releasenotes/index.rst @@ -0,0 +1,44 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International +.. License. +.. http://creativecommons.org/licenses/by/4.0 +.. (c) OPNFV, Ericsson AB and others. + +============================================= + Release Notes +============================================= + +Abstract +=================== +Preface to what this document is about + +License +======= +Include Licensing information here + +Version History +=============== + + ++-------------+-----------+-----------------+----------------------+ +| **Date** | **Ver.** | **Authors** | **Comment** | +| | | | | ++-------------+-----------+-----------------+----------------------+ +| YYYY-MM-DD | X.X.X | Name | Comments | ++-------------+-----------+-----------------+----------------------+ +| YYYY-MM-DD | X.X.X | Name | Comments |+-------------+-----------+-----------------+----------------------+ +| YYYY-MM-DD | X.X.X | Name | Comments | ++-------------+-----------+-----------------+----------------------+ + +Contents +=============== + +.. toctree:: + :maxdepth: 2 + + summary + version + compatibility + bugs + deliverables + scenario/index + references diff --git a/docs/release/templates/releasenotes/newfeatures.rst b/docs/release/templates/releasenotes/newfeatures.rst new file mode 100644 index 000000000..eab36cdca --- /dev/null +++ b/docs/release/templates/releasenotes/newfeatures.rst @@ -0,0 +1,23 @@ +============================================= + New Features +============================================= + + +Major Capabilities and Enhancements +===================================== +Provide information about the major capabilities this project provides +in this release. Include those from previous release unless they have +been deprecated or removed (see below). + +New Capabilities and Enhancements +==================================== +Call out the new capabilities and/or enhancements that are present in +this release, but were not present in prior releases. + + ++--------------------------------------+--------------------------------------+ +| **JIRA REFERENCE** | **SLOGAN** | +| | | ++--------------------------------------+--------------------------------------+ +| JIRA: | Brief here | ++--------------------------------------+--------------------------------------+ diff --git a/docs/release/templates/releasenotes/references.rst b/docs/release/templates/releasenotes/references.rst new file mode 100644 index 000000000..590aeb587 --- /dev/null +++ b/docs/release/templates/releasenotes/references.rst @@ -0,0 +1,5 @@ +============================================== + References +============================================== + +List references \ No newline at end of file diff --git a/docs/release/templates/releasenotes/scenario/.rst b/docs/release/templates/releasenotes/scenario/.rst new file mode 100644 index 000000000..47c85ec15 --- /dev/null +++ b/docs/release/templates/releasenotes/scenario/.rst @@ -0,0 +1,37 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 +.. (c) + + +============================================= + Release Notes +============================================= + + +Introduction +============ +.. In this section explain the purpose of the scenario and the types of capabilities provided + +Scenario components and composition +=================================== +.. In this section describe the unique components that make up the scenario, +.. what each component provides and why it has been included in order +.. to communicate to the user the capabilities available in this scenario. + +Scenario usage overview +======================= +.. Provide a brief overview on how to use the scenario and the features available to the +.. user. This should be an "introduction" to the userguide document, and explicitly link to it, +.. where the specifics of the features are covered including examples and API's + +Limitations, Issues and Workarounds +=================================== +.. Explain scenario limitations here, this should be at a design level rather than discussing +.. faults or bugs. If the system design only provide some expected functionality then provide +.. some insight at this point. + +References +========== + +For more information on the OPNFV Colorado release, please visit +http://www.opnfv.org/colorado \ No newline at end of file diff --git a/docs/release/templates/releasenotes/scenario/index.rst b/docs/release/templates/releasenotes/scenario/index.rst new file mode 100644 index 000000000..7a2cf9bb1 --- /dev/null +++ b/docs/release/templates/releasenotes/scenario/index.rst @@ -0,0 +1,16 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International +.. License. +.. http://creativecommons.org/licenses/by/4.0 +.. (c) OPNFV, Ericsson AB and others. + +============================================= + Scenario Release Notes +============================================= + + +=================== + +.. toctree:: + :maxdepth: 2 + + diff --git a/docs/release/templates/releasenotes/version.rst b/docs/release/templates/releasenotes/version.rst new file mode 100644 index 000000000..ba552595a --- /dev/null +++ b/docs/release/templates/releasenotes/version.rst @@ -0,0 +1,13 @@ +============================================== + Version +============================================== + + +Module version changes +======================== +List module level version changes + + +Document Version Changes +========================== +Changes in documentation \ No newline at end of file diff --git a/docs/release/templates/userguide/feature.userguide.rst b/docs/release/templates/userguide/feature.userguide.rst new file mode 100644 index 000000000..517f93d2f --- /dev/null +++ b/docs/release/templates/userguide/feature.userguide.rst @@ -0,0 +1,18 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 +.. (c) + + description +===================== +.. Describe the specific features and how it is realised in the scenario in a brief manner +.. to ensure the user understand the context for the user guide instructions to follow. + + capabilities and usage +================================ +.. Describe the specific capabilities and usage for feature. +.. Provide enough information that a user will be able to operate the feature on a deployed scenario. + + +----------------------------------------------- +.. Describe with examples how to use specific features, provide API examples and details required to +.. operate the feature on the platform. diff --git a/docs/release/templates/userguide/index.rst b/docs/release/templates/userguide/index.rst new file mode 100644 index 000000000..820155fdf --- /dev/null +++ b/docs/release/templates/userguide/index.rst @@ -0,0 +1,23 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 +.. (c) + +===================== + User Guide +===================== + +.. The feature user guide should provide an OPNFV user with enough information to +.. use the features provided by the feature project in the supported scenarios. +.. This guide should walk a user through the usage of the features once a scenario +.. has been deployed and is active according to the installation guide provided +.. by the installer project. + +.. toctree:: + :maxdepth: 2 + +.. The feature.userguide.rst file should contain the text for this document +.. additional documents can be added to this directory and added in the right order +.. to this file as a list below. + + ./feature.userguide.rst + -- cgit 1.2.3-korg