do stuff

photon-lib/py/docs/source/conf.py

@@ -28,10 +28,20 @@ extensions = [
 import os
 import sys
 
+sys.path.insert(
+    0, os.path.abspath(os.path.join(os.path.dirname(__file__), "..", "_stubs"))
+)  # add docs stubs first so they shadow unavailable third-party packages
+
 sys.path.insert(
     0, os.path.abspath("../../photonlibpy")
 )  # adjust based on your project layout
-print(sys.path)
+# Mock imports that aren't available in the docs build environment so autodoc
+# can import the local modules even if optional runtime deps (like wpimath)
+# aren't installed. Add other names here if you see warnings for missing
+# third-party packages during the build.
+autodoc_mock_imports = [
+    "wpilib",
+]
 templates_path = ["_templates"]
 exclude_patterns = []
 

photon-lib/py/docs/source/index.rst

@@ -4,7 +4,7 @@
    contain the root `toctree` directive.
 
 PhotonLib Python Documentation
-==========================
+===============================
 
 
 The main documentation for PhotonVision can be found at `photonvision.org <https://photonvision.org>`_.
@@ -14,4 +14,4 @@ The main documentation for PhotonVision can be found at `photonvision.org <https
    :caption: Contents:
 
    modules
-   photonlibpy  # if you have these .rst files from sphinx-apidoc
+   photonlibpy