summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorRich Bennett <rb2745@att.com>2017-08-08 12:49:50 +0000
committerGerrit Code Review <gerrit@onap.org>2017-08-08 12:49:50 +0000
commite6af771992ef632695c9e46a4c2053b4a22036c0 (patch)
treeba3214d9d2a9a6fc129ac5b4e9ed616b0512126d /docs
parent444b4261de14ca7706be540313e87cdee0016b48 (diff)
parent9f0875c33d54bf716b18e2ab5d674a77463bdad1 (diff)
Merge "[DOC-24] Add Component Template, Sphinx 1.6.3"
Diffstat (limited to 'docs')
-rw-r--r--docs/conf.py9
-rw-r--r--docs/templates/component-info/consumed-apis.csv1
-rw-r--r--docs/templates/component-info/index.rst65
-rw-r--r--docs/templates/component-info/offered-apis.csv2
-rw-r--r--docs/templates/release/release-notes/index.rst11
-rw-r--r--docs/templates/release/release-notes/release-notes.rst27
6 files changed, 73 insertions, 42 deletions
diff --git a/docs/conf.py b/docs/conf.py
index b3d753323..2ecd6d528 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -24,7 +24,7 @@ import shlex
# -- General configuration ------------------------------------------------
# If your documentation needs a minimal Sphinx version, state it here.
-#needs_sphinx = '1.0'
+needs_sphinx = '1.6.3'
# Add any Sphinx extension module names here, as strings. They can be
# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
@@ -34,8 +34,9 @@ extensions = [
'sphinx.ext.doctest',
'sphinx.ext.graphviz',
'sphinx.ext.todo',
- 'sphinx.ext.pngmath',
+ 'sphinx.ext.imgmath',
'sphinx.ext.viewcode',
+ 'sphinxcontrib.blockdiag'
]
# Add any paths that contain templates here, relative to this directory.
@@ -62,9 +63,9 @@ author = u'ONAP Contributors'
# built documents.
#
# The short X.Y version.
-version = 'test'
+version = 'pre-release alpha'
# The full version, including alpha/beta/rc tags.
-release = 'test'
+release = 'Amsterdam 0.1 alpha'
# The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages.
diff --git a/docs/templates/component-info/consumed-apis.csv b/docs/templates/component-info/consumed-apis.csv
new file mode 100644
index 000000000..811d1755d
--- /dev/null
+++ b/docs/templates/component-info/consumed-apis.csv
@@ -0,0 +1 @@
+repo.subrepo.subrepo|API Reference
diff --git a/docs/templates/component-info/index.rst b/docs/templates/component-info/index.rst
new file mode 100644
index 000000000..e438da8e0
--- /dev/null
+++ b/docs/templates/component-info/index.rst
@@ -0,0 +1,65 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+XXXX Component Information
+==========================
+High level architecture, design, and packaging information for release planning and delivery.
+
+.. toctree::
+ :maxdepth: 1
+
+
+Delivery
+--------
+Th package component is composed of the functional layers and packaged into run-time components as illustrated in the following diagrams.
+
+.. 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;
+ }
+
+ }
+
+
+Offered APIs
+------------
+
+.. csv-table::
+ :header-rows: 0
+ :header: "Container or Library", "API Reference", "Purpose", "Protocol", "Port", "TCP/UDP"
+ :widths: 20, 25, 25, 10, 10, 10
+ :delim: |
+ :file: offered-apis.csv
+
+
+Consumed APIs
+-------------
+
+.. csv-table::
+ :header-rows: 0
+ :header: "Project Repo/Group ID", "Container or Library Offering API"
+ :widths: 30, 30
+ :delim: |
+ :file: consumed-apis.csv
+
+Logging & Diagnostic Information
+--------------------------------
+Description of how to interact with and diagnose problems with the components in the run-time packaging.
diff --git a/docs/templates/component-info/offered-apis.csv b/docs/templates/component-info/offered-apis.csv
new file mode 100644
index 000000000..6300998f6
--- /dev/null
+++ b/docs/templates/component-info/offered-apis.csv
@@ -0,0 +1,2 @@
+XXX Container|API Reference link|Create or Delete XYZ|xxx|9999|TCP
+YYY Library|API Reference link|Create or Delete XYZ|xxxx|xxxx|xxxx
diff --git a/docs/templates/release/release-notes/index.rst b/docs/templates/release/release-notes/index.rst
deleted file mode 100644
index e703944ef..000000000
--- a/docs/templates/release/release-notes/index.rst
+++ /dev/null
@@ -1,11 +0,0 @@
-.. This work is licensed under a Creative Commons Attribution 4.0 International License.
-.. http://creativecommons.org/licenses/by/4.0
-
-****************************
-<Project Name> Release Notes
-****************************
-
-.. toctree::
- :maxdepth: 1
-
- release-notes
diff --git a/docs/templates/release/release-notes/release-notes.rst b/docs/templates/release/release-notes/release-notes.rst
deleted file mode 100644
index 002463d86..000000000
--- a/docs/templates/release/release-notes/release-notes.rst
+++ /dev/null
@@ -1,27 +0,0 @@
-.. This work is licensed under a Creative Commons Attribution 4.0 International License.
-
-
-This document provides the release notes for <RELEASE> of <COMPONENT>.
-
-.. contents::
- :depth: 3
- :local:
-
-
-
-Important notes
-===============
-
-<STATE IMPORTANT NOTES/DEVIATIONS SINCE PREVIOUS ITERATIVE RELEASE AND OTHER IMPORTANT NOTES FOR THIS RELEASE>
-
-<EXAMPLE>:
-
-
-
-Summary
-=======
-
-<SUMMARIZE THE RELEASE - THE CONTENT - AND OTHER IMPORTANT HIGH LEVEL PROPERTIES>
-
-<EXAMPLE>:
-