Skip to content

docs: add pydoc-markdown doc-generation scripts for Python API reference#689

Open
twishabansal wants to merge 4 commits into
docs/api-ref-site-scaffoldfrom
docs/api-ref-gen-scripts
Open

docs: add pydoc-markdown doc-generation scripts for Python API reference#689
twishabansal wants to merge 4 commits into
docs/api-ref-site-scaffoldfrom
docs/api-ref-gen-scripts

Conversation

@twishabansal

@twishabansal twishabansal commented Jun 22, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds the doc-generation scripts that turn the SDK source into the Hugo site PR #688 scaffolds.

Commits are split so copy and edit never mix. Commit 1 copies the scripts directly from the Go SDK repo. Following commits perform edits.

Testing

Built each package as its own site root (the production model) and served the static tree:

BASE=http://localhost:8000/
pip install -r docs-site/requirements.txt
rm -rf docs-site/public
bash scripts/generate-api-docs.sh core       dev "$BASE"
bash scripts/generate-api-docs.sh adk        dev "$BASE"
bash scripts/generate-api-docs.sh langchain  dev "$BASE"
bash scripts/generate-api-docs.sh llamaindex dev "$BASE"
bash scripts/generate-root.sh "$BASE"
cd docs-site/public && python3 -m http.server 8000

On the pinned toolchain (Hugo 0.152.2 extended + pydoc-markdown 4.8.2), manually verified at localhost:8000.

@twishabansal twishabansal marked this pull request as ready for review June 22, 2026 08:37
@twishabansal twishabansal requested a review from a team as a code owner June 22, 2026 08:37
@twishabansal twishabansal added the do not merge Indicates a pull request not ready for merge, due to either quality or timing. label Jun 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

do not merge Indicates a pull request not ready for merge, due to either quality or timing.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants