Migrate to autodoc to mkdocs-api-autonav

Author: johnthagen

docs/gen_ref_pages.py

@@ -24,6 +24,7 @@ theme:
     - content.code.copy
     - content.tabs.link
     - content.tooltips
+    - navigation.indexes
     - navigation.expand
     - navigation.footer
     - navigation.instant
@@ -65,12 +66,9 @@ plugins:
             show_if_no_docstring: true
             show_signature_annotations: true
   # Autodoc configuration.
-  # https://mkdocstrings.github.io/recipes/#automatic-code-reference-pages
-  - gen-files:
-      scripts:
-        - docs/gen_ref_pages.py
-  - literate-nav:
-      nav_file: SUMMARY.md
+  # https://github.com/tlambert03/mkdocs-api-autonav#configuration
+  - api-autonav:
+      modules: ["src/fact"]
   # This plugin is used to validate URLs (including anchors).
   - htmlproofer:
       # This is not enabled by default because this requires network I/O, so it is inherently not
@@ -88,4 +86,3 @@ repo_url: https://github.com/johnthagen/python-blueprint
 edit_uri: edit/main/docs/user_guide/docs/
 nav:
   - index.md
-  - Code Reference: reference/

mkdocs.yml

@@ -60,8 +60,7 @@ docs = [
     # Python API documentation (not neccessary for applications).
     "mkdocstrings[python]",
     # Autodoc.
-    "mkdocs-gen-files",
-    "mkdocs-literate-nav",
+    "mkdocs-api-autonav",
 ]
 licenses = [
     "pip-licenses-cli",