Add docstrings to all public package

src/openflexure_microscope_server/__init__.py

@@ -0,0 +1,17 @@
+"""The OpenFlexure Microscope Server Package.
+
+The OpenFlexure Microscope Server is a LabThings-FastAPI server. All hardware
+interfaces, and almost all functionality exposed over HTTP is done using ``Things``.
+
+On the microscope the server is started by systemd. It can be controlled using commands
+such as ``ofm restart``, ``ofm start``, and ``ofm stop``.
+
+The server can also be run in simulation mode from the terminal. In the root directory
+of the repository the server can be started with run:
+
+.. code-block:: bash
+
+    openflexure-microscope-server --fallback -c ./ofm_config_simulation.json
+
+
+"""

src/openflexure_microscope_server/server/__init__.py

@@ -1,3 +1,5 @@
+"""A package responsible for, setup, booting, and shutting down the server."""
+
 from __future__ import annotations
 
 from typing import Optional, Callable

src/openflexure_microscope_server/things/__init__.py

@@ -0,0 +1,5 @@
+"""A package for all of the core LabThings-FastAPI Things shipped with the microscope.
+
+The microscope can be extended to be used with other hardware by creating a package
+with other Things and including them in the LabThings-FastAPI config file.
+"""

src/openflexure_microscope_server/things/stage/__init__.py

@@ -1,3 +1,14 @@
+"""A package for stage control Things.
+
+`BaseStage` is the base class that provides core stage functionality, but
+no hardware interface control. To create a stage Thing to control a specific
+piece of hardware the BaseStage should be subclassed, and any method raising
+a NotImplementedError should be created.
+
+As the object will be used as a context manager create the hardware connection in
+``__enter__`` (not in ``__init__``), and close the connection with ``__exit__``.
+"""
+
 from __future__ import annotations
 from collections.abc import Sequence, Mapping