summaryrefslogtreecommitdiffstats
path: root/docs/templates
diff options
context:
space:
mode:
authorSofia Wallin <sofia.wallin@est.tech>2019-12-18 11:37:55 +0100
committerSofia Wallin <sofia.wallin@est.tech>2020-03-25 11:27:32 +0100
commit7a91adfce195b72dd02a431c60e43752b38084ee (patch)
tree12bc98975c633e6ffd5a07d0c665f141003d73d7 /docs/templates
parentbb425e3d3629b4a4fbfdd52b6783ee2e6d8b4ff1 (diff)
Refined release note template
Issue-ID: DOC-575 Signed-off-by: Sofia Wallin <sofia.wallin@est.tech> Change-Id: I2649e6f662865375801b35ae3c00828e606d88ee
Diffstat (limited to 'docs/templates')
-rw-r--r--docs/templates/sections/release-notes.rst98
1 files changed, 66 insertions, 32 deletions
diff --git a/docs/templates/sections/release-notes.rst b/docs/templates/sections/release-notes.rst
index df6176029..238b70baf 100644
--- a/docs/templates/sections/release-notes.rst
+++ b/docs/templates/sections/release-notes.rst
@@ -1,60 +1,94 @@
.. This work is licensed under a Creative Commons Attribution 4.0 International License.
.. http://creativecommons.org/licenses/by/4.0
+.. (c) ONAP Project and its contributors
+***********************
+<project> Release Notes
+***********************
-Release Notes
-=============
+Abstract
+========
-.. 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.
+This document provides the release notes for the ``<releasename>`` release.
+Summary
+=======
-Version: x.y.z
---------------
+<Give a high level description of your project with regards to this specific release>
+
+
+Release Data
+============
+
++--------------------------------------+--------------------------------------+
+| **Project** | |
+| | |
++--------------------------------------+--------------------------------------+
+| **Docker images** | make sure you include all docker |
+| | images including the |
+| | release version |
+| | |
++--------------------------------------+--------------------------------------+
+| **Release designation** | |
+| | |
++--------------------------------------+--------------------------------------+
+| **Release date** | |
+| | |
++--------------------------------------+--------------------------------------+
+New features
+------------
-:Release Date: yyyy-mm-dd
+<Describe new features or other new additions>
+Deliverables
+------------
-**New Features**
+Software Deliverables
+~~~~~~~~~~~~~~~~~~~~~
-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.
+Documentation Deliverables
+~~~~~~~~~~~~~~~~~~~~~~~~~~
- Another sentence explaining the impact of the issue.
- And an optional sentence providing a workaround.
+Known Limitations, Issues and Workarounds
+=========================================
-**Security Notes**
+System Limitations
+------------------
-*Fixed Security Issues*
- List of security issues fixed in this release including CVEs and OJSI tickets.
+Known Vulnerabilities
+---------------------
-*Known Security Issues*
- List of new security issues that are left unfixed in this release including CVEs and OJSI tickets.
+Workarounds
+-----------
+
+
+Security Notes
+--------------
+
-*Known Vulnerabilities in Used Modules*
+Test Results
+============
+List or refer to any project specific results
- Results of know vulnerabilities analysis in used modules.
-**Upgrade Notes**
+References
+==========
-**Deprecation Notes**
+For more information on the ONAP ``<release name>`` release, please see:
-**Other**
+#. `ONAP Home Page`_
+#. `ONAP Documentation`_
+#. `ONAP Release Downloads`_
+#. `ONAP Wiki Page`_
-===========
-End of Release Notes
+.. _`ONAP Home Page`: https://www.onap.org
+.. _`ONAP Wiki Page`: https://wiki.onap.org
+.. _`ONAP Documentation`: https://docs.onap.org
+.. _`ONAP Release Downloads`: https://git.onap.org