diff --git a/.readthedocs.yaml b/.readthedocs.yaml
new file mode 100644
index 0000000..3310942
--- /dev/null
+++ b/.readthedocs.yaml
@@ -0,0 +1,16 @@
+version: 2
+
+build:
+  os: ubuntu-24.04
+  tools:
+    python: "3.12"
+
+mkdocs:
+  configuration: mkdocs.yml
+
+python:
+  install:
+    - method: pip
+      path: .
+      extra_requirements:
+        - doc
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 07f43a5..863b277 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -202,6 +202,7 @@ To create a custom workflow, extend `DDMD_manager`:
 ```python
 from ddmd import DDMD_manager
 
+
 class MyWorkflow(DDMD_manager):
     def __init__(self, asyncflow, **kwargs):
         super().__init__(asyncflow)
@@ -212,20 +213,15 @@ class MyWorkflow(DDMD_manager):
         pass
 
     # Implement required abstract methods
-    def stop_simulation(self, prediction):
-        ...
+    def stop_simulation(self, prediction): ...
 
-    async def init_sim_queue(self):
-        ...
+    async def init_sim_queue(self): ...
 
-    async def check_train_data(self):
-        ...
+    async def check_train_data(self): ...
 
-    async def train_model(self):
-        ...
+    async def train_model(self): ...
 
-    async def clean_sim_data(self, sim_ind):
-        ...
+    async def clean_sim_data(self, sim_ind): ...
 ```
 
 ## Questions?
diff --git a/README.md b/README.md
index 55087c7..1ef373c 100644
--- a/README.md
+++ b/README.md
@@ -114,7 +114,7 @@ class DDMdWrapperWorkflow(BaseWorkflow):
             asyncflow=self.asyncflow,
             config=replica_config_path,
             name=replica_id.replace("_", ""),
-            on_ready=lambda: self._signal_done(),   # ← CM hook
+            on_ready=lambda: self._signal_done(),  # ← CM hook
             policies=self.policies,
             engine_dragon=self.engine_dragon,
         )
diff --git a/mkdocs.yml b/mkdocs.yml
index 6710736..d0ea554 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -45,7 +45,7 @@ plugins:
   - mkdocstrings:
       handlers:
         python:
-          paths: [src]
+          paths: ["."]
           options:
             docstring_style: google
             show_source: true