Add docs for annotation

Author: me-pic

.pre-commit-config.yaml

@@ -1,6 +1,9 @@
 ci:
     autoupdate_schedule: quarterly
 
+default_language_version:
+  python: python3.10
+
 # See https://pre-commit.com for more information
 # See https://pre-commit.com/hooks.html for more hooks
 repos:
@@ -22,13 +25,13 @@ repos:
       - id: rst-inline-touching-normal
 
 -   repo: https://github.com/codespell-project/codespell
-    rev: v2.4.2
+    rev: v2.4.1
     hooks:
       - id: codespell
         args: ["-L", "trough,troughs"]
 
 - repo: https://github.com/astral-sh/ruff-pre-commit
-  rev: v0.15.20
+  rev: v0.14.10
   hooks:
       - id: ruff
         name: ruff linter

docs/user_guide/editing.rst

@@ -47,11 +47,21 @@ red highlight):
 
 .. image:: physio_edit.gif
 
+It is also possible to annotate segments. To do so, you will need to enter the
+'annotation mode' by doing ``ctrl+a``. Once you are in that mode, segments could
+be selected (left click + drag). A yellow window will appear on your timeserie.
+Added segments will be track in the Physio instance history. Return back in
+'edit mode' (to delete peak) with ``ctrl+e``.
+
+.. image:: physio_edit_segment.gif
+
+NOTE: Currently overlap in segments are not permitted.
+
 If you accidentally reject or delete peaks, you can undo the selection with
-``ctrl+z`` (or ``command+z`` if you're on a Mac). The interactive viewer will
-track your history of edits as long as it is open, so you can undo multiple
-selections, if desired. Once done, you can close the interactive viewer by
-pressing ``ctrl+q`` (``command+q``).
+``ctrl+z`` (or ``command+z`` if you're on a Mac). This is also applicable to
+selected segments. The interactive viewer will track your history of edits as
+long as it is open, so you can undo multiple selections, if desired. Once done,
+you can close the interactive viewer by pressing ``ctrl+q`` (``command+q``).
 
 All edits performed in the editor are stored in the :py:attr:`~.Physio.history`
 of the data object, as with other operations, ensuring a record of your manual