Fix platform-api.rst toctree to correctly link autoapi docs

- Use relative path for toctree entry to chipflow-lib/autoapi/chipflow/index
- Exclude chipflow-lib/platform-api.rst since we use root level platform-api.rst
- Updated comments for clarity

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: robtaylor

docs/source/conf.py

@@ -25,8 +25,7 @@
     sys.path.append(str(r))
 
 # Create platform-api.rst in docs/source/ (outside chipflow-lib to avoid copy_docs overwriting)
-# Uses autoapi instead of autodoc directives (autodoc requires chipflow to be installed)
-# Note: Warning about "nonexisting document" is expected - autoapi generates files after toctree parsing
+# This file points to the autoapi-generated index
 Path('platform-api.rst').write_text("""Platform API Reference
 ======================
 
@@ -35,7 +34,7 @@
 .. toctree::
    :maxdepth: 3
 
-   /chipflow-lib/autoapi/chipflow/index
+   chipflow-lib/autoapi/chipflow/index
 """)
 
 # Update chipflow-lib/index.rst to point to the platform-api.rst outside chipflow-lib/
@@ -120,7 +119,7 @@
     'imported-members',
 ]
 autoapi_root = "chipflow-lib/autoapi"
-autoapi_add_toctree_entry = False  # Don't auto-add to toctree (we link manually)
+autoapi_add_toctree_entry = False  # We'll manually add to toctree in platform-api.rst
 autoapi_ignore = [
     "*/chipflow_lib/*",  # Backward compatibility shim
 ]
@@ -130,6 +129,7 @@
     autoapi_template_dir,
     "chipflow-lib/unfinished",
     "chipflow-lib/UNFINISHED_IDEAS.md",
+    "chipflow-lib/platform-api.rst",  # We use /platform-api.rst at root instead
     "amaranth/cover.rst",
     "amaranth-soc/cover.rst",
 ]