Add 21.10 release notes

Add 21.10 release notes page

Update release notes template

Change-Id: I9f9587bf5d5d4e2f352829de5bdda48741a8f2d7

doc/source/2110.rst

@@ -0,0 +1,135 @@
+.. _release_notes_21.10:
+
+=================================
+21.10 (Draft version in progress)
+=================================
+
+Summary of changes
+------------------
+
+* New charm features
+   * `<TITLE>`_
+
+* New tech-preview charms
+   * `<TITLE>`_
+
+* Informational notices
+   * `<TITLE>`_
+
+* Deprecation notices
+   * `<TITLE>`_
+
+* Removed features
+   * `<TITLE>`_
+
+Overview
+--------
+
+The 21.10 OpenStack Charms release includes updates for the charms described on
+the `Charms`_ page. As of this release, the project consists of
+<NUMBER-OF-STABLE-CHARMS> supported (stable) charms.
+
+For the list of bugs resolved in this release refer to the `21.10 milestone`_
+in Launchpad.
+
+For scheduling information of past and future releases see the `Release
+schedule`_.
+
+General charm information is published in the `OpenStack Charm Guide`_ (this
+guide) which ultimately supersedes Release Notes contents.
+
+.. important::
+
+   Always upgrade to the latest stable charms before making any major changes
+   to your cloud and before filing bug reports. Refer to section `Upgrading
+   charms`_ below for details.
+
+New charm features
+------------------
+
+With each new feature, there is a corresponding example bundle in the form of a
+test bundle, and/or a section in the `OpenStack Charms Deployment Guide`_, that
+details its usage. Test bundles are located in the ``src/tests/bundles``
+directory of the relevant charm repository (see all `charm repositories`_).
+
+<TITLE>
+~~~~~~~
+
+New stable charms
+-----------------
+
+<TITLE>
+~~~~~~~
+
+New tech-preview charms
+-----------------------
+
+<TITLE>
+~~~~~~~
+
+Preview charm features
+----------------------
+
+<TITLE>
+~~~~~~~
+
+Documentation updates
+---------------------
+
+<TITLE>
+~~~~~~~
+
+Informational notices
+---------------------
+
+<TITLE>
+~~~~~~~
+
+Deprecation notices
+-------------------
+
+<TITLE>
+~~~~~~~
+
+Removed features
+----------------
+
+<TITLE>
+~~~~~~~
+
+Removed charms
+--------------
+
+<TITLE>
+~~~~~~~
+
+Issues discovered during this release cycle
+-------------------------------------------
+
+<TITLE>
+~~~~~~~
+
+Upgrading charms
+----------------
+
+Upgrading charms will making available new features and bug fixes. However, the
+latest stable charm revision should also be used prior to making any
+topological changes, application migrations, workload upgrades, or series
+upgrades. Bug reports should also be filed against the most recent revision.
+
+Note that charm upgrades and OpenStack upgrades are functionally different. For
+instructions on performing the different upgrade types see `Upgrades overview`_
+in the `OpenStack Charms Deployment Guide`_.
+
+.. LINKS
+.. _Charms: openstack-charms.html
+.. _21.10 milestone: https://launchpad.net/openstack-charms/+milestone/21.10
+.. _OpenStack Charms Deployment Guide: https://docs.openstack.org/project-deploy-guide/charm-deployment-guide/latest
+.. _OpenStack Charm Guide: https://docs.openstack.org/charm-guide/latest/
+.. _Release schedule: release-schedule.html
+.. _Upgrades overview: https://docs.openstack.org/project-deploy-guide/charm-deployment-guide/latest/upgrade-overview.html
+.. _charm repositories: https://opendev.org/openstack?sort=alphabetically&q=charm-&tab=
+
+.. COMMITS
+
+.. BUGS

doc/source/release-notes-template.rst

@@ -20,6 +20,9 @@ Summary of changes
 * New tech-preview charms
    * `<TITLE>`_
 
+* Informational notices
+   * `<TITLE>`_
+
 * Deprecation notices
    * `<TITLE>`_
 
@@ -56,44 +59,62 @@ test bundle, and/or a section in the `OpenStack Charms Deployment Guide`_, that
 details its usage. Test bundles are located in the ``src/tests/bundles``
 directory of the relevant charm repository (see all `charm repositories`_).
 
-<NEW-FEATURE-TITLE>
-~~~~~~~~~~~~~~~~~~~
+<TITLE>
+~~~~~~~
 
-.. COMMENT
-   New stable charms
-   -----------------
+New stable charms
+-----------------
 
-.. COMMENT
-   New tech-preview charms
-   -----------------------
+<TITLE>
+~~~~~~~
 
-.. COMMENT
-   Preview charm features
-   ----------------------
+New tech-preview charms
+-----------------------
 
-.. COMMENT
-   Documentation updates
-   ---------------------
+<TITLE>
+~~~~~~~
 
-.. COMMENT
-   Informational notices
-   ---------------------
+Preview charm features
+----------------------
 
-.. COMMENT
-   Deprecation notices
-   -------------------
+<TITLE>
+~~~~~~~
 
-.. COMMENT
-   Removed features
-   ----------------
+Documentation updates
+---------------------
 
-.. COMMENT
-   Removed charms
-   --------------
+<TITLE>
+~~~~~~~
 
-.. COMMENT
-   Issues discovered during this release cycle
-   -------------------------------------------
+Informational notices
+---------------------
+
+<TITLE>
+~~~~~~~
+
+Deprecation notices
+-------------------
+
+<TITLE>
+~~~~~~~
+
+Removed features
+----------------
+
+<TITLE>
+~~~~~~~
+
+Removed charms
+--------------
+
+<TITLE>
+~~~~~~~
+
+Issues discovered during this release cycle
+-------------------------------------------
+
+<TITLE>
+~~~~~~~
 
 Upgrading charms
 ----------------

doc/source/release-notes.rst

@@ -4,7 +4,7 @@ Release Notes
 
 **Pending Release Notes**
 
-* ...
+* `21.10 release`_
 
 **Latest Release Notes**
 
@@ -43,6 +43,7 @@ Release Notes
    :maxdepth: 1
    :hidden:
 
+   2110
    2104
    2103_Trilio
    2101
@@ -63,6 +64,7 @@ Release Notes
    1610
 
 .. LINKS
+.. _21.10 release: 2110.html
 .. _21.04 release: 2104.html
 .. _21.03 Trilio release: 2103_Trilio.html
 .. _21.01 release: 2101.html