docs: Structured changelog

- A structure of the release notes to be used from 5.0 onwards. Can be improved. #9552
- Merged upgrading instructions into changelog.

docs/admin/upgrade.rst

@@ -418,15 +418,6 @@ Please follow :ref:`generic-upgrade-instructions` in order to perform update.
 
 .. seealso:: :ref:`generic-upgrade-instructions`
 
-Upgrade from 4.18 to 5.0
-~~~~~~~~~~~~~~~~~~~~~~~~
-
-Please follow :ref:`generic-upgrade-instructions` in order to perform update.
-
-* There are several changes in :file:`settings_example.py`, most notable is change in ``CACHES``, please adjust your settings accordingly.
-
-.. seealso:: :ref:`generic-upgrade-instructions`
-
 .. _py3:
 
 Upgrading from Python 2 to Python 3

docs/changes.rst

@@ -3,13 +3,26 @@ Weblate 5.0
 
 Not yet released.
 
-* Improved plurals handling in machine translation.
-* Fixed user names handling while committing to Git.
-* :ref:`addon-weblate.cleanup.blank` and :ref:`addon-weblate.cleanup.generic` now remove all strings at once.\
+**New features**
+
+**Improvements**
+
+* Plurals handling in machine translation.
 * :ref:`check-same` check now honors placeholders even in the strict mode.
 * :ref:`check-reused` is no longer triggered for languages with a single plural form.
-* Fixed language filtering in :doc:`/devel/reporting`.
 * WebP is now supported for :ref:`screenshots`.
 * Avoid duplicate notification when a user is subscribed to overlapping scopes.
 
+**Bug fixes**
+
+* User names handling while committing to Git.
+* :ref:`addon-weblate.cleanup.blank` and :ref:`addon-weblate.cleanup.generic` now remove all strings at once.
+* Language filtering in :doc:`/devel/reporting`.
+
+**Upgrading**
+
+Please follow :ref:`generic-upgrade-instructions` in order to perform update.
+
+* There are several changes in :file:`settings_example.py`, most notable is change in ``CACHES``, please adjust your settings accordingly.
+
 `All changes in detail <https://github.com/WeblateOrg/weblate/milestone/99?closed=1>`__.