From 2bb2b057014156b3972c8d3ac04c082a77ce3802 Mon Sep 17 00:00:00 2001
From: Leandro Lucarella <luca-frequenz@llucax.com>
Date: Thu, 21 Nov 2024 10:09:53 +0100
Subject: [PATCH] Clear release notes

Signed-off-by: Leandro Lucarella <luca-frequenz@llucax.com>
---
 RELEASE_NOTES.md | 30 +++++++++++++-----------------
 1 file changed, 13 insertions(+), 17 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index d5242cb3..4a01ccc2 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -2,32 +2,28 @@
 
 ## Summary
 
-This version accumulates a few improvements, and bumps the dependency of setuptools to use v75, which is compatible with PEP625, which is necessary to be able to keep uploading to PyPI, so you should upgrade to this version as soon as possible.
-
-The migration script was also rewritten in Python, so it should be more compatible with different OSes.
+<!-- Here goes a general summary of what this release is about -->
 
 ## Upgrading
 
-- The `frequenz.repo.config.github.abort()` function now takes most arguments as keyword-only arguments.
-- The *Queue PRs for v0.x.x* GitHub ruleset was renamed to *Queue PRs for the default branch* and now targets the default branch. It also only have the merge queue restriction, all other restrictions were removed as they are already present in the *Protect version branches* ruleset. You might want to re-import this ruleset to your repositories.
+<!-- Here goes notes on how to upgrade from previous versions, including deprecations and what they should be replaced with -->
+
+### Cookiecutter template
+
+<!-- Here upgrade steps for cookiecutter specifically -->
 
 ## New Features
 
-* Added a new GitHub branch ruleset for Rust projects.
+<!-- Here goes the main new features and examples or instructions on how to use them -->
 
 ### Cookiecutter template
 
-* Group GitHub Actions dependabot updates.
-* API projects don't include the `google-common-protos` dependency by default.
-* API projects updated the `grpcio` dependency to `1.66.1`.
-* API projects updated the `frequenz-api-common` dependency to `0.6`.
-* Bump most of the dependencies.
-* Change `edit_uri` default branch to v0.x.x in mkdocs.yml.
-* Added a new default option `asyncio_default_fixture_loop_scope = "function"` for `pytest-asyncio` as not providing a value is deprecated.
-* The migration script is now written in Python, so it should be (hopefully) more compatible with different OSes.
-* Disable more `pylint` checks that are also checked by `mypy` to avoid false positives.
-* Remove the redundant `--platform` from the testing dockerfile.
+<!-- Here new features for cookiecutter specifically -->
 
 ## Bug Fixes
 
-* Sybil now parses the `__init__.py` file as well. Previously it was disabled due to an upstream bug.
+<!-- Here goes notable bug fixes that are worth a special mention or explanation -->
+
+### Cookiecutter template
+
+<!-- Here bug fixes for cookiecutter specifically -->