Update

Author: svekars

docs/source/conf.py

@@ -186,17 +186,25 @@ def get_version_path():
     "docutils",  # Suppress docstring formatting issues from third-party libraries
     "app.add_node",  # Suppress node warnings
     "app.add_directive",  # Suppress directive warnings
+    "ref.class",  # Suppress missing reference warnings
+    "ref.func",  # Suppress missing function reference warnings
+    "ref.meth",  # Suppress missing method reference warnings
 ]
 
 # Treat warnings as non-fatal - continue build even if there are warnings
 keep_warnings = True
 
+# Don't fail the build on warnings - important for handling third-party library docstrings
+# This is especially important when dependencies (like torchtitan) have RST formatting
+# that may not be perfect but works with Napoleon extension
+nitpicky = False  # Don't be overly strict about references
+
 # Napoleon settings for Google-style docstrings (from torchtitan and other dependencies)
 napoleon_google_docstring = True
 napoleon_numpy_docstring = True
 napoleon_use_param = True
 napoleon_use_rtype = True
-napoleon_preprocess_types = False
+napoleon_use_ivar = True
 
 
 # -- Sphinx Gallery configuration -------------------------------------------