diff options
author | Dan Timoney <dtimoney@att.com> | 2017-10-10 16:59:25 -0400 |
---|---|---|
committer | Dan Timoney <dtimoney@att.com> | 2017-10-10 16:59:25 -0400 |
commit | eb1a9209bb408256799869da53cffaf4d6751cfb (patch) | |
tree | 0cf28a6ec6c5a6a54cd495ce68076359c0bc405a | |
parent | 5fabcb07493f5da2b6af49ec1b31ecb5034179d0 (diff) |
Add readthedocs templates
Add readthedocs templates for sli/core
Change-Id: I2efaad7720997ef51c4dcb9036de5011bc6a1c4b
Issue-ID: CCSDK-107
Signed-off-by: Dan Timoney <dtimoney@att.com>
-rwxr-xr-x | .gitignore | 1 | ||||
-rw-r--r-- | docs/architecture.rst | 27 | ||||
-rw-r--r-- | docs/build.rst | 23 | ||||
-rw-r--r-- | docs/index.rst | 16 | ||||
-rw-r--r-- | docs/logging.rst | 22 | ||||
-rw-r--r-- | docs/offeredapis.rst | 16 | ||||
-rw-r--r-- | docs/release-notes.rst | 46 |
7 files changed, 142 insertions, 9 deletions
diff --git a/.gitignore b/.gitignore index 319e695b1..a36bed326 100755 --- a/.gitignore +++ b/.gitignore @@ -17,6 +17,7 @@ workspace target target-ide MANIFEST.MF +**/yang-gen-sal ## Misc Ignores (OS specific etc) ## bin/ diff --git a/docs/architecture.rst b/docs/architecture.rst new file mode 100644 index 000000000..a1956d59f --- /dev/null +++ b/docs/architecture.rst @@ -0,0 +1,27 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 + +Architecture +============ + +.. note:: + * This section is used to describe a software component from a high level + view of capability, common usage scenarios, and interactions with other + components required in the usage scenarios. + + * The architecture section is typically: provided in a platform-component + and sdk collections; and referenced from developer and user guides. + + * This note must be removed after content has been added. + + +Capabilities +------------ + + +Usage Scenarios +--------------- + + +Interactions +------------ diff --git a/docs/build.rst b/docs/build.rst new file mode 100644 index 000000000..99a061c24 --- /dev/null +++ b/docs/build.rst @@ -0,0 +1,23 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 + +Build +===== + +.. note:: + * This section is used to describe how a software component is built from source + into something ready for use either in a run-time environment or to build other + components. + + * This section is typically provided for a platform-component, application, and sdk; and + referenced in developer guides. + + * This note must be removed after content has been added. + + +Environment +----------- + + +Steps +----- diff --git a/docs/index.rst b/docs/index.rst index 3a4849b2d..2055f1780 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -1,15 +1,13 @@ .. This work is licensed under a Creative Commons Attribution 4.0 International License. -SDNC Service Logic Interpreter ------------------------------- +CCSDK Service Logic Interpreter +------------------------------- .. toctree:: :maxdepth: 1 -Offered APIs -============ -List of Northbound APIs + architecture.rst + offeredapis.rst + logging.rst + build.rst + release-notes.rst -SLI-API(2016-11-11) -================== - -.. swaggerv2doc:: https://gerrit.onap.org/r/gitweb?p=ccsdk/sli/core.git;a=blob_plain;f=sliapi/model/src/main/resources/ sli-api.20161110.json diff --git a/docs/logging.rst b/docs/logging.rst new file mode 100644 index 000000000..5662acb1f --- /dev/null +++ b/docs/logging.rst @@ -0,0 +1,22 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 + +Logging +======= + +.. note:: + * This section is used to describe the informational or diagnostic messages emitted from + a software component and the methods or collecting them. + + * This section is typically: provided for a platform-component and sdk; and + referenced in developer and user guides + + * This note must be removed after content has been added. + + +Where to Access Information +--------------------------- + + +Error / Warning Messages +------------------------ diff --git a/docs/offeredapis.rst b/docs/offeredapis.rst new file mode 100644 index 000000000..de686ad36 --- /dev/null +++ b/docs/offeredapis.rst @@ -0,0 +1,16 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 + +Offered APIs +============ + +.. toctree:: + :maxdepth: 1 + :titlesonly: + +SLI-API(2016-11-11) +=================== + +.. swaggerv2doc:: https://gerrit.onap.org/r/gitweb?p=ccsdk/sli/core.git;a=blob_plain;f=sliapi/model/src/main/resources/sli-api.20161110.json + + diff --git a/docs/release-notes.rst b/docs/release-notes.rst new file mode 100644 index 000000000..b45165706 --- /dev/null +++ b/docs/release-notes.rst @@ -0,0 +1,46 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. + +Release Notes +============= + +.. note:: + * This Release Notes must be updated each time the team decides to Release new artifacts. + * The scope of this Release Notes is for this particular component. In other words, each ONAP component has its Release Notes. + * This Release Notes is cumulative, the most recently Released artifact is made visible in the top of this Release Notes. + * Except the date and the version number, all the other sections are optional but there must be at least one section describing the purpose of this new release. + * This note must be removed after content has been added. + + +Version: x.y.z +-------------- + + +:Release Date: yyyy-mm-dd + + + +**New Features** + +One or two sentences explaining the purpose of this Release. + +**Bug Fixes** + - `CIMAN-65 <https://jira.onap.org/browse/CIMAN-65>`_ and a sentence explaining what this defect is addressing. +**Known Issues** + - `CIMAN-65 <https://jira.onap.org/browse/CIMAN-65>`_ and two, three sentences. + One sentences explaining what is the issue. + + Another sentence explaining the impact of the issue. + + And an optional sentence providing a workaround. + +**Security Issues** + You may want to include a reference to CVE (Common Vulnerabilities and Exposures) `CVE <https://cve.mitre.org>`_ + + +**Upgrade Notes** + +**Deprecation Notes** + +**Other** + +===========
\ No newline at end of file |