summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorEric Debeau <eric.debeau@orange.com>2020-03-25 13:34:42 +0000
committerGerrit Code Review <gerrit@onap.org>2020-03-25 13:34:42 +0000
commit0a21dbb9f2c31ebe611559ea76d93bf591ffdc8f (patch)
tree86ffc3eb85838978a96656c2db6d2d8500755220
parent965ddfc9fb8b0a366dbf9c8d04250eb48246a177 (diff)
parent7a91adfce195b72dd02a431c60e43752b38084ee (diff)
Merge "Refined release note template"
-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