docs: Add initial SDK DocGen

Author: holtskinner

.github/workflows/docs.yml

@@ -17,9 +17,14 @@ jobs:
         run: |
           git config user.name github-actions[bot]
           git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+      - name: Checkout a2a-python repo
+        uses: actions/checkout@v4
+        with:
+          repository: google/a2a-python
+          path: a2a-python-repo
       - uses: actions/setup-python@v5
         with:
-          python-version: 3.x
+          python-version-file: pyproject.toml
       - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
       - uses: actions/cache@v4
         with:

a2a-python-repo

@@ -0,0 +1 @@
+Subproject commit d1869bb8a74f8a630eae3a7ec434b54d68cae6b4

docs/sdk/python/index.md

@@ -0,0 +1,11 @@
+# Python SDK Reference
+
+This page contains SDK documentation for the [`a2a-python`](https://github.com/a2a-python) package.
+
+::: a2a
+    options:
+        show_root_heading: false
+        show_source: false
+        show_submodules: true
+        members_order: alphabetical
+        inherited_members: true

mkdocs.yml

@@ -27,6 +27,8 @@ nav:
     - Interact with Server: tutorials/python/6-interact-with-server.md
     - Streaming & Multiturn: tutorials/python/7-streaming-and-multiturn.md
     - Next Steps: tutorials/python/8-next-steps.md
+  - SDK Reference:
+    - Python: sdk/python/index.md
 
 # Repository
 repo_name: google/A2A
@@ -138,3 +140,10 @@ plugins:
         "tutorials/python/8-agent-capabilities.md": "tutorials/python/7-streaming-and-multiturn.md"
         "tutorials/python/9-ollama-agent.md": "tutorials/python/7-streaming-and-multiturn.md"
         "tutorials/python/10-next-steps.md": "tutorials/python/8-next-steps.md"
+  - mkdocstrings:
+      handlers:
+        python:
+          options:
+            show_root_heading: false
+            show_object_full_path: false
+            paths: [a2a-python-repo/src]

requirements-docs.txt

@@ -1,2 +1,3 @@
 mkdocs-material==9.6.12
 mkdocs-redirects==1.2.2
+mkdocstrings[python]