From dbc4302b0545e9be70fd14b2c711364f77a92f41 Mon Sep 17 00:00:00 2001
From: Leandro Lucarella <luca-frequenz@llucax.com>
Date: Wed, 26 Nov 2025 10:06:46 +0100
Subject: [PATCH] Clear release notes

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

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 558627e..92616f8 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -2,21 +2,16 @@
 
 ## Summary
 
-This release main change is the introduction of a new `metrics` package compatible with the common API v0.8 (`v1alpha8`) (the old `metric` package, in singular, still works with the old v0.5/`v1` version).
+<!-- Here goes a general summary of what this release is about -->
 
-## Deprecations
+## Upgrading
 
-- The old `frequenz.client.common.enum_proto` module is now deprecated, please use `frequenz.client.common.proto.enum_from_proto` instead.
+<!-- Here goes notes on how to upgrade from previous versions, including deprecations and what they should be replaced with -->
 
 ## New Features
 
-- New `frequenz.client.common.common.proto` module with conversion utilities for protobuf types:
-  - `enum_from_proto()` (moved from `enum_proto).
-  - `datetime_to_proto()` and `datetime_from_proto()` functions to convert between Python `datetime` and protobuf `Timestamp` (imported from `frequenz-client-base`.
-- New `metrics` package compatible with API v0.8, which includes:
-  - `Metric` enum with all supported metrics.
-  - `MetricSample` dataclass to represent metric samples.
-  - `AggregatedMetricValue` dataclass to represent derived statistical summaries.
-  - `Bounds` dataclass to represent bounds for metrics.
-  - `MetricConnection` and `MetricConnectionCategory` to represent connections from which metrics are obtained.
-  - `proto` submodule with conversion functions to/from protobuf types.
+<!-- Here goes the main new features and examples or instructions on how to use them -->
+
+## Bug Fixes
+
+<!-- Here goes notable bug fixes that are worth a special mention or explanation -->