From 9f0875c33d54bf716b18e2ab5d674a77463bdad1 Mon Sep 17 00:00:00 2001 From: Rich Bennett Date: Mon, 7 Aug 2017 21:38:02 -0400 Subject: [PATCH] [DOC-24] Add Component Template, Sphinx 1.6.3 Change-Id: Ib810ef3354ff17da35c57f563ecd8e15e9250fa3 Signed-off-by: Rich Bennett --- docs/conf.py | 9 +-- docs/templates/component-info/consumed-apis.csv | 1 + docs/templates/component-info/index.rst | 65 ++++++++++++++++++++++ docs/templates/component-info/offered-apis.csv | 2 + docs/templates/release/release-notes/index.rst | 11 ---- .../release/release-notes/release-notes.rst | 27 --------- etc/requirements.txt | 3 +- 7 files changed, 75 insertions(+), 43 deletions(-) create mode 100644 docs/templates/component-info/consumed-apis.csv create mode 100644 docs/templates/component-info/index.rst create mode 100644 docs/templates/component-info/offered-apis.csv delete mode 100644 docs/templates/release/release-notes/index.rst delete mode 100644 docs/templates/release/release-notes/release-notes.rst 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 - -**************************** - 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 of . - -.. contents:: - :depth: 3 - :local: - - - -Important notes -=============== - - - -: - - - -Summary -======= - - - -: - diff --git a/etc/requirements.txt b/etc/requirements.txt index 8ad711f2a..f01ad1c62 100644 --- a/etc/requirements.txt +++ b/etc/requirements.txt @@ -1,8 +1,9 @@ tox -Sphinx==1.3.1 +Sphinx==1.6.3 doc8 docutils setuptools six sphinxcontrib-httpdomain +sphinxcontrib-blockdiag sphinx_bootstrap_theme>=0.4.11 -- 2.16.6