Merge pull request #154 from scipp/docs-fixes

Docs fixes

Author: jl-wynen

src/ess/reduce/ui.py

@@ -257,9 +257,11 @@ def set_parameter_widget_values(
 
     Example
     -------
-    {
-        'WavelengthBins': {'start': 1.0, 'stop': 14.0, 'nbins': 500}
-    }
+    .. code-block::
+
+        set_parameter_widget_values(widget, {
+            'WavelengthBins': {'start': 1.0, 'stop': 14.0, 'nbins': 500}
+        })
 
     Parameters
     ----------

src/ess/reduce/uncertainty.py

@@ -13,7 +13,7 @@
 helper function.
 """
 
-from enum import Enum
+from enum import Enum, auto
 from typing import TypeVar, overload
 
 import numpy as np
@@ -23,18 +23,18 @@
 T = TypeVar("T", bound=sc.Variable | sc.DataArray)
 
 
-UncertaintyBroadcastMode = Enum(
-    'UncertaintyBroadcastMode', ['drop', 'upper_bound', 'fail']
-)
-"""
-Mode for broadcasting uncertainties.
+class UncertaintyBroadcastMode(Enum):
+    """Mode for broadcasting uncertainties.
 
-- `drop`: Drop variances if the data is broadcasted.
-- `upper_bound`: Compute an upper bound for the variances.
-- `fail`: Do not broadcast, simply return the input data.
+    See https://doi.org/10.3233/JNR-220049 for context.
+    """
 
-See https://doi.org/10.3233/JNR-220049 for context.
-"""
+    drop = auto()
+    """Drop variances if the data is broadcast."""
+    upper_bound = auto()
+    """Compute an upper bound for the variances."""
+    fail = auto()
+    """Do not broadcast, simply return the input data."""
 
 
 @overload