summaryrefslogtreecommitdiffstats
path: root/docs/templates/component-info
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/component-info
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/component-info')
-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
3 files changed, 68 insertions, 0 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