diff --git a/doc/changelog.rst b/doc/changelog.rst
index afe7bbf3d436f6f2dbd74ba2af498d5d43bd0a23..69206ee19238f99607b3688b180566ce208a56b7 100644
--- a/doc/changelog.rst
+++ b/doc/changelog.rst
@@ -1,6 +1,18 @@
 Release Notes
 =============
 
+unreleased
+----------
+
+- **Bug fixes**
+  
+- **Improvements**
+
+    - reorganize the Howto section :mr:`169`
+  
+- **New Features**
+
+
 1.5.0
 -----
 
diff --git a/doc/howtos.rst b/doc/howtos.rst
index ee0fce4f9278ca5cf16312a74739cfb7ca20807a..d9ea91ec129990ea822da643270134189fd2574a 100644
--- a/doc/howtos.rst
+++ b/doc/howtos.rst
@@ -3,23 +3,20 @@
 How to's
 ~~~~~~~~
 
-top
----
+Loading run data
+----------------
 
-.. * :doc:`load run and data <load>`.
+* :doc:`load run and data <load>`.
 * :doc:`load data in memory <Loading_data_in_memory>`.
 
-misc
-----
+Reading the bunch pattern
+-------------------------
 
 * :doc:`bunch pattern decoding <bunch_pattern_decoding>`.
 
 
-detectors
----------
-
 DSSC
-++++
+----
 
 DSSC data binning
 #################
@@ -80,22 +77,13 @@ Most of the functions within toolbox_scs.detectors can be accessed directly. Thi
 * :doc:`bin data using the DSSCBinner <dssc/DSSCBinner>`.
 * post processing, data analysis -> *to be documented*
 
-Point detectors
-+++++++++++++++
-Detectors that produce one point per pulse, or 0D detectors, are all handled in a similar way. Such detectors are, for instance, the X-ray Gas Monitor (XGM), the Transmitted Intensity Monitor (TIM), the electron Bunch Arrival Monitor (BAM) or the photo diodes monitoring the PP laser.
-
-* :doc:`extract data from point detectors <point_detectors/point_detectors>`.
-
 Photo-Electron Spectrometer (PES)
-+++++++++++++++++++++++++++++++++
+---------------------------------
 
 * :doc:`Basic analysis of PES spectra <PES_spectra_extraction>`.
 
-routines
---------
-
 BOZ: Beam-Splitting Off-axis Zone plate analysis
-++++++++++++++++++++++++++++++++++++++++++++++++
+------------------------------------------------
 
 The BOZ analysis consists of 4 notebooks and a script. The first notebook
 :doc:`BOZ analysis part I.a Correction determination <BOZ analysis part I.a Correction determination>`
@@ -136,3 +124,9 @@ That small data h5 file can then be loaded and the data binned to compute a
 spectrum or a time resolved XAS scan using the fourth and final notebook
 :doc:`BOZ analysis part II.2 Binning <BOZ analysis part II.2 Binning>`
 
+Point detectors
+---------------
+Detectors that produce one point per pulse, or 0D detectors, are all handled in a similar way. Such detectors are, for instance, the X-ray Gas Monitor (XGM), the Transmitted Intensity Monitor (TIM), the electron Bunch Arrival Monitor (BAM) or the photo diodes monitoring the PP laser.
+
+* :doc:`extract data from point detectors <point_detectors/point_detectors>`.
+