Temporarily disable AutoAPI generation due to CI import issues

AutoAPI is encountering "Unable to read file" warnings for all modules
in the CI environment, preventing documentation from building. The root
cause appears to be related to module import resolution in CI that does
not occur locally.

Changes:
- Set autoapi_generate_api_docs = False in docs/conf.py
- Removed duplicate ../chipflow_lib/platforms from autoapi_dirs
- Removed all autoapi references from documentation files
- Documentation now relies on manual API documentation in platform-api.rst

This is a temporary workaround to unblock CI. AutoAPI should be re-enabled
once the underlying import issues are resolved.

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

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

Author: robtaylor

docs/architecture.rst

@@ -116,7 +116,7 @@ When you run ``chipflow pin lock``:
 
 The ``pins.lock`` file maps abstract interface names to concrete package pin locations:
 
-.. code-block:: json
+.. code-block:: javascript
 
     {
       "uart.tx": {"pin": "42", "loc": "A12"},
@@ -270,7 +270,7 @@ The annotation system is central to how ChipFlow propagates metadata:
 
    Pydantic TypeAdapter generates JSON schema from TypedDict:
 
-   .. code-block:: json
+   .. code-block:: javascript
 
        {
          "$schema": "https://json-schema.org/draft/2020-12/schema",

docs/conf.py

@@ -33,7 +33,7 @@
     'sphinx.ext.duration',
     'sphinx.ext.intersphinx',
     'sphinx.ext.napoleon',
-    'autoapi.extension',
+    # 'autoapi.extension',  # Temporarily disabled due to CI import issues
     'sphinxcontrib.autoprogram',
     'sphinxcontrib.autodoc_pydantic',
     'sphinx_design',
@@ -55,24 +55,24 @@
 
 autodoc_typehints = 'description'
 
-autoapi_dirs = [
-        "../chipflow_lib/platforms",
-        "../chipflow_lib",
-        ]
-autoapi_generate_api_docs = True
-autoapi_template_dir = "_templates/autoapi"
-# autoapi_verbose_visibility = 2
-autoapi_keep_files = True
-autoapi_options = [
-    'members',
-    'show-inheritance',
-    'show-module-summary',
-    'imported-members',
-]
-
-# Exclude autoapi templates and in-progress stuff
+# AutoAPI configuration - temporarily disabled due to CI import issues
+# autoapi_dirs = [
+#         "../chipflow_lib",
+#         ]
+# autoapi_generate_api_docs = False
+# autoapi_template_dir = "_templates/autoapi"
+# # autoapi_verbose_visibility = 2
+# autoapi_keep_files = True
+# autoapi_options = [
+#     'members',
+#     'show-inheritance',
+#     'show-module-summary',
+#     'imported-members',
+# ]
+
+# Exclude in-progress stuff and template files
 exclude_patterns = [
-    autoapi_template_dir,
+    "_templates",  # Exclude template files from being read as RST
     "unfinished",
 ]
 

docs/contributor-pin-signature-internals.rst

@@ -779,4 +779,3 @@ See Also
 --------
 
 - :doc:`using-pin-signatures` - User-facing guide for using pin signatures
-- :doc:`autoapi/chipflow_lib/platform/index` - Full platform API reference

docs/index.rst

@@ -15,7 +15,6 @@ It is developed at https://github.com/chipFlow/chipflow-lib/ and licensed `BSD 2
    chipflow-toml-guide
    chipflow-commands
    using-pin-signatures
-   API Reference <autoapi/index>
    platform-api
 
 .. toctree::

docs/platform-api.rst

@@ -3,8 +3,6 @@ Platform API Reference
 
 This page documents the complete public API of the ``chipflow_lib.platform`` module.
 
-For auto-generated documentation, see :doc:`autoapi/chipflow_lib/platform/index`.
-
 Re-exported Symbols
 -------------------
 

docs/using-pin-signatures.rst

@@ -399,5 +399,4 @@ See Also
 --------
 
 - :doc:`chipflow-toml-guide` - Configuring your ChipFlow project
-- :doc:`autoapi/chipflow_lib/platform/index` - Platform API reference
 - :doc:`platform-api` - Complete platform API including SimPlatform and attach_data