summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorShubhamRathi <shubhamiiitbackup@gmail.com>2017-01-10 18:20:30 +0530
committerChristopher Price <christopher.price@ericsson.com>2017-01-15 16:26:41 +0000
commit326c546133c46a8fa51aee3631cc23d71cacaca4 (patch)
tree6c62e8e41239e8922b7891d2b3ea879e118050a3 /docs
parent26e52332eb28812b3415aaefc6f53a7637a222fe (diff)
Add new templates for docs contribution
Adding new templates for docs contribution to be used by the project teams. Templates for 'Testing/' havent been added yet since its not perfectly clear what all cases need to be documented. Change-Id: Id9c1d0d87d99bb071cbcd493817500666cd59b79 Signed-off-by: ShubhamRathi <shubhamiiitbackup@gmail.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/development/Templates/Design/design.rst0
-rw-r--r--docs/development/Templates/Design/index.rst17
-rw-r--r--docs/development/Templates/Integration/index.rst15
-rw-r--r--docs/development/Templates/Scenario/index.rst15
-rw-r--r--docs/development/Templates/Scenario/scenario.description.rst31
-rw-r--r--docs/release/Templates/Installation/<scenario>/<scenario>-installation.rst22
-rw-r--r--docs/release/Templates/Installation/<scenario>/<scenario>-postinstallation.rst17
-rw-r--r--docs/release/Templates/Installation/<scenario>/index.rst10
-rw-r--r--docs/release/Templates/Installation/abstract.rst6
-rw-r--r--docs/release/Templates/Installation/compatibility.rst18
-rw-r--r--docs/release/Templates/Installation/index.rst18
-rw-r--r--docs/release/Templates/Installation/prerequisite.rst15
-rw-r--r--docs/release/Templates/Installation/supportedscenario.rst13
-rw-r--r--docs/release/Templates/Overview/index.rst18
-rw-r--r--docs/release/Templates/Overview/overview.rst13
-rw-r--r--docs/release/Templates/ReleaseNotes/bugs.rst63
-rw-r--r--docs/release/Templates/ReleaseNotes/compatibility.rst18
-rw-r--r--docs/release/Templates/ReleaseNotes/deliverables.rst12
-rw-r--r--docs/release/Templates/ReleaseNotes/index.rst44
-rw-r--r--docs/release/Templates/ReleaseNotes/newfeatures.rst23
-rw-r--r--docs/release/Templates/ReleaseNotes/references.rst5
-rw-r--r--docs/release/Templates/ReleaseNotes/scenario/<scenarioname>.rst37
-rw-r--r--docs/release/Templates/ReleaseNotes/scenario/index.rst16
-rw-r--r--docs/release/Templates/ReleaseNotes/version.rst13
-rw-r--r--docs/release/Templates/userguide/feature.userguide.rst18
-rw-r--r--docs/release/Templates/userguide/index.rst23
26 files changed, 500 insertions, 0 deletions
diff --git a/docs/development/Templates/Design/design.rst b/docs/development/Templates/Design/design.rst
new file mode 100644
index 000000000..e69de29bb
--- /dev/null
+++ b/docs/development/Templates/Design/design.rst
diff --git a/docs/development/Templates/Design/index.rst b/docs/development/Templates/Design/index.rst
new file mode 100644
index 000000000..817a19440
--- /dev/null
+++ b/docs/development/Templates/Design/index.rst
@@ -0,0 +1,17 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) <optionally add copywriters name>
+
+=====================
+<feature> Design
+=====================
+
+.. describe which upstream components (e.g. OpenStack modules, ..) are working together to provide the functionality
+.. describe some deployment architecture
+.. fill the gap between the release notes and the detailed documentation provided by the participating projects or upstream communities
+
+.. toctree::
+ :maxdepth: 2
+
+ ./design.rst
+
diff --git a/docs/development/Templates/Integration/index.rst b/docs/development/Templates/Integration/index.rst
new file mode 100644
index 000000000..2e7dd06d3
--- /dev/null
+++ b/docs/development/Templates/Integration/index.rst
@@ -0,0 +1,15 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) <optionally add copywriters name>
+
+======================
+<feature> Integration
+======================
+
+Introduction
+==============
+..Brief on what scenario's the project can be integrated to.
+
+Integration Steps for <>
+===========================
+.. List steps to integrate <project> with <scenario>
diff --git a/docs/development/Templates/Scenario/index.rst b/docs/development/Templates/Scenario/index.rst
new file mode 100644
index 000000000..44605fe7a
--- /dev/null
+++ b/docs/development/Templates/Scenario/index.rst
@@ -0,0 +1,15 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) <optionally add copywriters name>
+
+===================================
+<scenario> Overview and Description
+===================================
+.. This document will be used to provide a description of the scenario for an end user.
+.. You should explain the purpose of the scenario, the types of capabilities provided and
+.. the unique components that make up the scenario including how they are used.
+
+.. toctree::
+ :maxdepth: 3
+
+ ./scenario.description.rst
diff --git a/docs/development/Templates/Scenario/scenario.description.rst b/docs/development/Templates/Scenario/scenario.description.rst
new file mode 100644
index 000000000..36098fd2f
--- /dev/null
+++ b/docs/development/Templates/Scenario/scenario.description.rst
@@ -0,0 +1,31 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) <optionally add copywriters name>
+
+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 Danube release, please visit
+http://www.opnfv.org/danube
diff --git a/docs/release/Templates/Installation/<scenario>/<scenario>-installation.rst b/docs/release/Templates/Installation/<scenario>/<scenario>-installation.rst
new file mode 100644
index 000000000..a8cef90ba
--- /dev/null
+++ b/docs/release/Templates/Installation/<scenario>/<scenario>-installation.rst
@@ -0,0 +1,22 @@
+=============================================
+<Project Name> <Release Name> Installation
+=============================================
+
+
+Preparing for Installation
+=====================================
+Include any pre configuration, database, or other software downloads
+required to install <project>.
+
+Installing <Feature>
+====================================
+Installation toolkit
+
+Verifying your Installation
+====================================
+Describe how to verify the installation.
+
+Troubleshooting
+====================================
+<optional>
+Text goes here. \ No newline at end of file
diff --git a/docs/release/Templates/Installation/<scenario>/<scenario>-postinstallation.rst b/docs/release/Templates/Installation/<scenario>/<scenario>-postinstallation.rst
new file mode 100644
index 000000000..f60537566
--- /dev/null
+++ b/docs/release/Templates/Installation/<scenario>/<scenario>-postinstallation.rst
@@ -0,0 +1,17 @@
+=================================================
+<Project Name> <Release Name> Post Installation
+=================================================
+
+
+Post Installation Configuration
+=====================================
+Post Installation Configuration section must include some basic
+(must-do) procedures if any, to get started.
+
+Upgrading From <a Previous Release>
+====================================
+Text goes here.
+
+?Uninstalling? <Feature>
+====================================
+Text here.
diff --git a/docs/release/Templates/Installation/<scenario>/index.rst b/docs/release/Templates/Installation/<scenario>/index.rst
new file mode 100644
index 000000000..053e341d5
--- /dev/null
+++ b/docs/release/Templates/Installation/<scenario>/index.rst
@@ -0,0 +1,10 @@
+===================================
+<Scenario> Installation Guide
+===================================
+
+.. toctree::
+ :maxdepth: 2
+
+ prerequisite
+ <scenario>-installation
+ <scenario>-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 @@
+=============================================
+<Project Name> <Release Name> 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 @@
+==============================================
+<Project Name> <Release Name> Compatibility
+==============================================
+
+
+Compatibility with Previous Releases
+=======================================
+<optional, required if there's a previous release>
+Is it compatible? Did anything about how a user or developer would
+consume it change? If so, document it here.
+
+Migration from Previous Releases
+=====================================
+<optional, required if there's a previous release for the project>
+
+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 @@
+===================================
+<Project Name> Installation Guide
+===================================
+
+Installation Guide
+===================
+Refer to https://wiki.opnfv.org/display/DOC/Installation+procedure
+Naming Convention is: <Name> <Use Case> <file name>. Eg: Apex Installation Guide Abstract
+
+.. toctree::
+ :maxdepth: 2
+
+ abstract
+ prerequisite
+ supportedscenario
+ <scenario>/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 @@
+=============================================
+<Project Name> <Release Name> 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 @@
+===================================================
+<Project Name> <Release Name> Supported Scenarios
+===================================================
+
+<Brief>
+=========
+Add a short brief about supported scenarios
+
+.. toctree::
+ :maxdepth: 2
+
+ development/<scenario1>/index
+ development/<scenario2>/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.
+
+=============================================
+<Project Name> <Release Name> Overview
+=============================================
+
+For example, the title might be "Qtip Danube Overview"
+
+<Brief (Optional)>
+===================
+
+.. 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 @@
+==============================================
+<Project Name> <Release Name> Overview
+==============================================
+
+
+Introduction
+=======================================
+Describing the components and behaviours in a manner that helps people understand the platform and how to work with it
+
+Upgrades from <Previous Release>
+=====================================
+<optional, required if there's a previous release for the project>
+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 @@
+=============================================
+<Project Name> <Release Name> 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 @@
+==============================================
+<Project Name> <Release Name> Compatibility
+==============================================
+
+
+Compatibility with Previous Releases
+=======================================
+<optional, required if there's a previous release>
+Is it compatible? Did anything about how a user or developer would
+consume it change? If so, document it here.
+
+Migration from Previous Releases
+=====================================
+<optional, required if there's a previous release for the project>
+
+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 @@
+==============================================
+<Project Name> <Release Name> 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.
+
+=============================================
+<Project Name> <Release Name> 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 @@
+=============================================
+<Project Name> <Release Name> 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: <XXXXXX> | 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 @@
+==============================================
+<Project Name> <Release Name> References
+==============================================
+
+List references \ No newline at end of file
diff --git a/docs/release/Templates/ReleaseNotes/scenario/<scenarioname>.rst b/docs/release/Templates/ReleaseNotes/scenario/<scenarioname>.rst
new file mode 100644
index 000000000..47c85ec15
--- /dev/null
+++ b/docs/release/Templates/ReleaseNotes/scenario/<scenarioname>.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) <optionally add copywriters name>
+
+
+=============================================
+<Scenario> <Release Name> 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.
+
+=============================================
+<Release Name> Scenario Release Notes
+=============================================
+
+<Brief (Optional)>
+===================
+
+.. toctree::
+ :maxdepth: 2
+
+ <scenarioname>
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 @@
+==============================================
+<Project Name> <Release Name> 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) <optionally add copywriters name>
+
+<Feature> 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.
+
+<Feature> capabilities and usage
+================================
+.. Describe the specific capabilities and usage for <XYZ> feature.
+.. Provide enough information that a user will be able to operate the feature on a deployed scenario.
+
+<Feature and API usage guidelines and example>
+-----------------------------------------------
+.. 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) <optionally add copywriters name>
+
+=====================
+<feature> 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
+