diff options
author | Sofia Wallin <sofia.wallin@est.tech> | 2019-12-18 11:37:55 +0100 |
---|---|---|
committer | Sofia Wallin <sofia.wallin@est.tech> | 2020-03-25 11:27:32 +0100 |
commit | 7a91adfce195b72dd02a431c60e43752b38084ee (patch) | |
tree | 12bc98975c633e6ffd5a07d0c665f141003d73d7 /docs/templates | |
parent | bb425e3d3629b4a4fbfdd52b6783ee2e6d8b4ff1 (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.rst | 98 |
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 |