Clear release notes (#419)

Author: llucax

RELEASE_NOTES.md

@@ -1,11 +1,37 @@
 # Frequenz Repository Configuration Release Notes
 
+## Summary
+
+<!-- Here goes a general summary of what this release is about -->
+
+## Upgrading
+
+<!-- Here goes notes on how to upgrade from previous versions, including deprecations and what they should be replaced with -->
+
+### Cookiecutter template
+
+All upgrading should be done via the migration script or regenerating the templates.
+
+```bash
+curl -sSL https://raw.githubusercontent.com/frequenz-floss/frequenz-repo-config-python/v0.12/cookiecutter/migrate.py | python3
+```
+
+But you might still need to adapt your code:
+
+<!-- Here upgrade steps for cookiecutter specifically -->
+
+## New Features
+
+<!-- Here goes the main new features and examples or instructions on how to use them -->
+
+### Cookiecutter template
+
+<!-- Here new features for cookiecutter specifically -->
+
 ## Bug Fixes
 
-- Fixed some typos in the docs.
-- Fixed wrong comparison for `mike` versions when versions were equal.
-- Fixed version regex escaping of `.`. This means that a version like v0x1e1 were accepted as valid semver versions. Now this version is not considered a semver version anymore.
-- `setuptools.grpc_tools`: Fix wrong passing of include paths when passed via:
+<!-- Here goes notable bug fixes that are worth a special mention or explanation -->
+
+### Cookiecutter template
 
-    * Command-line: Now extra white-spaces and empty strings are removed, before they were passed to `protoc -I`.
-    * `pyproject.toml`: Now an empty array/list can be passed to override the default paths, before this resulted in an empty string being passed to `protoc -I`.
+<!-- Here bug fixes for cookiecutter specifically -->