diff --git a/mkdocs.yml b/mkdocs.yml
index d40f174d14..2a55bdeb86 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -14,7 +14,15 @@ plugins:
 - gen-files:
     scripts:
     - scripts/gen_ref_pages.py
-- mkdocstrings
+- mkdocstrings:
+    handlers:
+      python:
+        options:
+          docstring_style: google
+          members_order: source
+          show_root_heading: true
+          show_root_full_path: false
+          show_signature_annotations: true
 
 nav:
   - xDSL: index.md