Document commit message syntax, job directives, etc. Decorate as a cross-reference page to encourage reuse
Change-Id: I3f3b12cfd6cd3dd10a91b28a36f4e487fa25f464
diff --git a/howto/release/preparation.rst b/howto/release/preparation.rst
index 2c515d0..fe41e28 100644
--- a/howto/release/preparation.rst
+++ b/howto/release/preparation.rst
@@ -5,8 +5,15 @@
------------
As release date approaches and development slows visit the `jira versions dashboard <https://jira.opencord.org/projects/VOL?selectedItem=com.atlassian.jira.jira-projects-plugin%3Arelease-page&status=unreleased>`_.
-- Create a new dashboard for the future release candidate.
+- Create a new/empty dashboard for the future release candidate.
+
+ - Click in the ``Version name`` box and type in VOLTHA-(X.Y)++ for the next release.
+ - Enter start/end dates if known, they should overlap with the last release.
+
- Visit the current released candidate version and move all unresolved tickets into the future desktop.
+
+ - TSTs may want to review unresolved tickets for release notes content for partially completed work.
+
- On release day click the [Release] button to close out the desktop.
Confluence