Thanks, I Made It with Quartodoc
summary
Quartodoc automatically generates Python function reference pages as Quarto Markdown files, replicating pkgdown’s R-style index/reference/articles layout. It produces clean parameter tables and signatures, integrates with Quarto sites via a small YAML (about 17 lines), and builds with two commands to build and preview. Docs support embedded WASM/Shiny examples that run in-browser and accessibility features. Projects like ibis already adopt it, and the system works as a drop-in replacement for heavy Sphinx setups.
AI-written summary · about
chapters (9)
- 0:00Introduction to docs
- 1:30The quest for Python docs
- 4:00Long format documentation
- 5:15API documentation and Sphinx
- 7:10Discovering Quarto for Python
- 8:45Configuring Quarto for docs
- 11:17Features and benefits
- 14:09Wasm and concluding thoughts
- 15:40Q&A and session close
related talks
01h 06mHello Quarto: Share, Collaborate, Teach, Reimagine
19mReproducible, dynamic, and elegant books with Quarto
43mInstall Python. Quarto Render All the Things
19mQuarto: A Multifaceted Publishing Powerhouse for Medical Researchers
21mQuarto for Knowledge Management
05mJSquarto: Bridging JavaScript Documentation with Quarto's Power
20mInstant Impact: Developing {docorator} to Simplify R Adoption for Teams
23mMkDocs: Documenting projects with Markdown