diff options
author | Rich Bennett <rb2745@att.com> | 2017-08-07 21:38:02 -0400 |
---|---|---|
committer | Rich Bennett <rb2745@att.com> | 2017-08-07 21:52:58 -0400 |
commit | 9f0875c33d54bf716b18e2ab5d674a77463bdad1 (patch) | |
tree | 7c31fe0832b5f37ae92d51824054e0be8aac678b /docs/templates | |
parent | a52a572b3401c86116fa014dd4249d06e54c976c (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.csv | 1 | ||||
-rw-r--r-- | docs/templates/component-info/index.rst | 65 | ||||
-rw-r--r-- | docs/templates/component-info/offered-apis.csv | 2 | ||||
-rw-r--r-- | docs/templates/release/release-notes/index.rst | 11 | ||||
-rw-r--r-- | docs/templates/release/release-notes/release-notes.rst | 27 |
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>: - |