summaryrefslogtreecommitdiffstats
path: root/docs/templates
diff options
context:
space:
mode:
authorRich Bennett <rb2745@att.com>2017-08-07 21:38:02 -0400
committerRich Bennett <rb2745@att.com>2017-08-07 21:52:58 -0400
commit9f0875c33d54bf716b18e2ab5d674a77463bdad1 (patch)
tree7c31fe0832b5f37ae92d51824054e0be8aac678b /docs/templates
parenta52a572b3401c86116fa014dd4249d06e54c976c (diff)
[DOC-24] Add Component Template, Sphinx 1.6.3
Change-Id: Ib810ef3354ff17da35c57f563ecd8e15e9250fa3 Signed-off-by: Rich Bennett <rb2745@att.com>
Diffstat (limited to 'docs/templates')
-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
5 files changed, 68 insertions, 38 deletions
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>:
-