diff --git a/doc/source/api_reference/hdf5_handler.rst b/doc/source/api_reference/hdf5_handler.rst
new file mode 100644
index 00000000..b35ce512
--- /dev/null
+++ b/doc/source/api_reference/hdf5_handler.rst
@@ -0,0 +1,5 @@
+.. _api_reference.hdf5_handler:
+
+============
+Hdf5 handler
+============
diff --git a/doc/source/api_reference/hdf5_io.rst b/doc/source/api_reference/hdf5_io.rst
new file mode 100644
index 00000000..2a83f385
--- /dev/null
+++ b/doc/source/api_reference/hdf5_io.rst
@@ -0,0 +1,5 @@
+.. _api_reference.hdf5_io:
+
+=======
+Hdf5 io
+=======
diff --git a/doc/source/api_reference/object_handler.rst b/doc/source/api_reference/object_handler.rst
new file mode 100644
index 00000000..6b8b8456
--- /dev/null
+++ b/doc/source/api_reference/object_handler.rst
@@ -0,0 +1,5 @@
+.. _api_reference.object_handler:
+
+==============
+Object handler
+==============
diff --git a/doc/source/release/0.5.0-notes.rst b/doc/source/release/0.5.0-notes.rst
index 025d3fee..2f613df2 100644
--- a/doc/source/release/0.5.0-notes.rst
+++ b/doc/source/release/0.5.0-notes.rst
@@ -8,15 +8,20 @@ smash 0.5.0 Release Notes
 
 The smash 0.5.0 release continues the ongoing work to improve the handling, fix possible bugs, clarify the documentation. The highlights are:
 
+- Reading atmospheric data with YYYY/MM/DD access
+- New regularization function
+- Spatial disaggregation/aggregation of the input raster
+- Fix bugs in mesh creation, signature calculation and regularization l-curve
+
 ------------
 Contributors
 ------------
 
 This release was made possible thanks to the contributions of:
 
----------------
-Compatibilities
----------------
+- Maxime Jay-Allemand
+- Ngo Nghi Truyen Huynh
+- François Colleoni
 
 ------------
 Deprecations
@@ -42,7 +47,7 @@ New Features
 ------------
 
 New regularization function
-****************************
+***************************
 
 hard-smoothing : the smoothing regularization function is applied on parameters or states directly. This behavior differs from the ``smoothing`` mode where the regularization is applied on the difference between the background and the control (parameters or states)