diff --git a/doc/changelog.rst b/doc/changelog.rst
index ee97fd599734b4324076f0a46fa60dc4fb62787b..641f6bf9a2aea80b7f67a7bfa279ea01c49760ba 100644
--- a/doc/changelog.rst
+++ b/doc/changelog.rst
@@ -13,6 +13,7 @@ unreleased
     - fix :issue:`67` regarding bunch pattern :mr:`245`
     - fix :issue:`44` regarding notebook for DSSC geometry quadrants alignment :mr:`247`
     - fix :issue:`52` use extra-geom detector helper function for azimuthal integration :mr:`248`
+    - fix :issue:`18` regarding using reserved partition with sbatch :mr:`250`
 
 
 - **Improvements**
diff --git a/doc/howtos.rst b/doc/howtos.rst
index 07fdef9f81536bba907c9646b088562d11c40718..5330f49d1f4800ae6cd715478fd77c141d2b1309 100644
--- a/doc/howtos.rst
+++ b/doc/howtos.rst
@@ -199,4 +199,31 @@ Viking spectrometer
 
 * :doc:`Analysis of Viking spectrometer data <Analysis_of_Viking_spectrometer_data>`
 
+SLURM, sbatch, partition, reservation
+-------------------------------------
+
+Scripts launched by ``sbatch`` command can employ magic cookie with
+``#SBATCH`` to pass options SLURM, such as which partition to run on.
+To work, the magic cookie has to be at the beginning of the line.
+This means that:
+
+* to comment out a magic cookie, adding another "#" before it is sufficient
+* to comment a line to detail what the option does, it is best practice
+  to put the comment on the line before
+
+Reserved partition are of the form "upex_003333" where 3333 is the proposal
+number. To check what reserved partition are existing, their start and end
+date, one can ``ssh`` to ``max-display`` and use the command ``sview``.
+
+.. image:: sview.png
+
+To use a reserved partition with ``sbatch``, one can use the magic cookie
+
+``#SBATCH --reservation=upex_003333``
+
+instead of the usual
+
+``#SBATCH --partition=upex``
+
+
 .. _pyFAI: https://pyfai.readthedocs.io
diff --git a/doc/sview.png b/doc/sview.png
new file mode 100644
index 0000000000000000000000000000000000000000..2a862cf98ca2d848cdcc2f7da91c9bec23addcfc
Binary files /dev/null and b/doc/sview.png differ