fix weird dataclass args formatting, show base classes, add watch to…

… sphinx running doc

doc/_templates/custom-module-template.rst

@@ -11,6 +11,7 @@
 
 .. automodule:: {{ fullname }}
     :members:
+    :show-inheritance:
 
     {% block modules %}
     {% if modules %}

doc/dev/set_up_dev_environment.md

@@ -67,4 +67,4 @@ the type of block expected by `demo_plan`
 
 To build the sphinx documentation locally run `sphinx-build doc _build` from the root of the repo. The generated output will be in the _build directory.
 
-If you want to preview changes live, you can run `sphinx-autobuild doc _build` from the root of the repo instead which will start a local, hot-reloadable web server. 
+If you want to preview changes live, you can run `sphinx-autobuild doc _build --watch src` from the root of the repo instead which will start a local, hot-reloadable web server. This should rebuild the documentation whenever you change anything in src, which in turn will rebuild the API reference pages. 

src/ibex_bluesky_core/devices/block.py

@@ -40,10 +40,12 @@
 class BlockWriteConfig(Generic[T]):
     """Configuration settings for writing to blocks.
 
-    use_completion_callback: Whether to wait for an EPICS completion callback while setting
+    use_completion_callback:
+        Whether to wait for an EPICS completion callback while setting
         this block. Defaults to true, which is appropriate for most blocks.
 
-    set_success_func: An arbitrary function which is called to decide whether the block has
+    set_success_func:
+        An arbitrary function which is called to decide whether the block has
         set successfully yet or not. The function takes (setpoint, actual) as arguments and
         should return true if the value has successfully set and is "ready", or False otherwise.
 
@@ -60,13 +62,15 @@ def check(setpoint: T, actual: T) -> bool:
 
         Defaults to None, which means no check is applied.
 
-    set_timeout_s: A timeout, in seconds, on the value being set successfully. The timeout
+    set_timeout_s:
+        A timeout, in seconds, on the value being set successfully. The timeout
         applies to the EPICS completion callback (if enabled) and the set success function
         (if provided), and excludes any configured settle time.
 
         Defaults to None, which means no timeout.
 
-    settle_time_s: A wait time, in seconds, which is unconditionally applied just before the set
+    settle_time_s:
+        A wait time, in seconds, which is unconditionally applied just before the set
         status is marked as complete. Defaults to zero.
 
     """