diff --git a/src/gat/cli_projects_v1.py b/src/gat/cli_projects_v1.py
index 97b8d1d..d5afc1f 100644
--- a/src/gat/cli_projects_v1.py
+++ b/src/gat/cli_projects_v1.py
@@ -590,6 +590,7 @@ def add_scenario(
     to absolute filesystem paths for storage.
 
     For Sienna scenarios:
+
     - If --simulation-type is specified (e.g., UC, ED, PF), creates a single scenario
       for that specific simulation type
     - If --simulation-type is NOT specified, auto-discovers all simulation types in the
diff --git a/src/gat/registry/__init__.py b/src/gat/registry/__init__.py
index 0b5bcb8..3034e51 100644
--- a/src/gat/registry/__init__.py
+++ b/src/gat/registry/__init__.py
@@ -38,9 +38,11 @@ def plot_function(
         The decorated function
 
     Example:
-        @plot_function("MultiScenario", "system")
-        def plot_generation_capacities(multi_scenario, **kwargs):
-            ...
+        ::
+
+            @plot_function("MultiScenario", "system")
+            def plot_generation_capacities(multi_scenario, **kwargs):
+                ...
     """
 
     def decorator(func: Callable) -> Callable: