X-Git-Url: https://gerrit.onap.org/r/gitweb?a=blobdiff_plain;f=docs%2Ftemplates%2Fsections%2Frelease-notes.rst;h=11f38fed9f5149654663395a505f9a33cf9f9e92;hb=3f17abe875d2fb008d60c06aaeb6c2d533467466;hp=238b70bafd233e7f244787793518f195328920b3;hpb=0a21dbb9f2c31ebe611559ea76d93bf591ffdc8f;p=doc.git

diff --git a/docs/templates/sections/release-notes.rst b/docs/templates/sections/release-notes.rst
index 238b70baf..11f38fed9 100644
--- a/docs/templates/sections/release-notes.rst
+++ b/docs/templates/sections/release-notes.rst
@@ -1,11 +1,20 @@
-.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. 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
+.. _release_notes:
 
 ***********************
 <project> Release Notes
 ***********************
 
+.. note::
+   * The release note needs to be updated for each ONAP release
+   * Except the section "Release data" all other sections are optional and should be
+     applied where applicable
+   * Only the current release is to be documented in this document
+   * This note needs to be removed before publishing the final result
+
 Abstract
 ========
 
@@ -14,33 +23,41 @@ This document provides the release notes for the ``<releasename>`` release.
 Summary
 =======
 
-<Give a high level description of your project with regards to this specific release>
+<Give a high level description of your project with regards to this
+specific release>
 
 
 Release Data
 ============
 
 +--------------------------------------+--------------------------------------+
-| **Project**                          |                                      |
+| **Project**                          | <project name>                       |
 |                                      |                                      |
 +--------------------------------------+--------------------------------------+
-| **Docker images**                    | make sure you include all docker     |
+| **Docker images**                    |  make sure you include all docker    |
 |                                      |  images including the                |
 |                                      |  release version                     |
 |                                      |                                      |
 +--------------------------------------+--------------------------------------+
-| **Release designation**              |                                      |
-|                                      |                                      |
-+--------------------------------------+--------------------------------------+
-| **Release date**                     |                                      |
+| **Release designation**              | <release name followed by version>   |
 |                                      |                                      |
 +--------------------------------------+--------------------------------------+
 
+
 New features
 ------------
 
 <Describe new features or other new additions>
 
+**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 to three sentences
+  explaining what this issue is.
 
 Deliverables
 ------------
@@ -59,18 +76,34 @@ Known Limitations, Issues and Workarounds
 System Limitations
 ------------------
 
+Any known system limitations.
+
 
 Known Vulnerabilities
 ---------------------
 
+Results of know vulnerabilities analysis in used modules.
+
 
 Workarounds
 -----------
 
+Any known workarounds.
+
 
 Security Notes
 --------------
 
+**Fixed Security Issues**
+
+List of security issues fixed in this release including CVEs and OJSI
+tickets.
+
+**Known Security Issues**
+
+List of new security issues that are left unfixed in this release including
+CVEs and OJSI tickets.
+
 
 Test Results
 ============