Skip to content

docs: migrate to Fumadocs with AI features#1680

Open
pcriadoperez wants to merge 4 commits intosammchardy:masterfrom
pcriadoperez:docs
Open

docs: migrate to Fumadocs with AI features#1680
pcriadoperez wants to merge 4 commits intosammchardy:masterfrom
pcriadoperez:docs

Conversation

@pcriadoperez
Copy link
Collaborator

@pcriadoperez pcriadoperez commented Mar 16, 2026

Summary

  • Applies lint fixes to examples and tests

  • Migrate documentation Fumadocs (Next.js + MDX)

  • Auto-generate API reference from Python docstrings (50 pages via griffe/fumadocs-python)

  • Convert all 16 RST guide files to 18 MDX pages

  • Add AI features: llms.txt, llms-full.txt, per-page .mdx endpoints, Ask AI chat (OpenRouter), "Open in Claude/ChatGPT/Cursor" buttons

  • Add LLM Integration page with agent skill install instructions

  • Deploy to Vercel at https://python-binancedocs.vercel.app

How to test

Replace the legacy Sphinx/RST documentation with a modern Fumadocs (Next.js) site featuring auto-generated API reference, AI chat, and LLM-readable outputs. - Scaffold Fumadocs with Next.js 16, Tailwind CSS 4, MDX content - Convert all 16 RST files to 18 MDX guide pages - Auto-generate 50 API reference pages from Python docstrings via griffe/fumadocs-python - Add llms.txt, llms-full.txt, and per-page .mdx endpoints for AI agents - Add Ask AI chat (OpenRouter) with streaming responses - Add per-page "Copy as Markdown" and "Open with..." (Claude, ChatGPT, Scira, Cursor, GitHub) - Add LLM Integration page with agent skill install instructions and copy buttons - Deploy to Vercel at python-binancedocs.vercel.app
- Move all Fumadocs files (app/, components/, content/, lib/, scripts/, config files) into docs/ subdirectory - Remove old Sphinx RST files, conf.py, Makefile, requirements.txt - Remove .readthedocs.yaml - Update GitHub source links to reflect new paths
- Fix whitespace and indentation issues in client.py, helpers.py, code-generator.py, and depth_cache_threaded_example.py - Restore .readthedocs.yaml (keep RTD alongside new Fumadocs)
- Restrict ruff to core E/W/F rules via lint.select in pyproject.toml - Auto-fix 983 whitespace/formatting errors (W293, E301, E303, etc.) - All checks pass with ruff check --target-version=py39
@pcriadoperez pcriadoperez marked this pull request as ready for review March 16, 2026 03:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

1 participant