Your documentation has two audiences now - humans reading the rendered HTML, and AI agents trying to make sense of your library. Rich Iannone and Michael Chow from Posit are back on Talk Python with a brand new Python documentation tool called Great Docs that takes both seriously. Rich is the creator of Great Tables, and before that the R package GT, the man has a serious eye for design, and he's pointed that energy at the Python docs ecosystem. We'll talk about how Great Docs spins up a polished site in three commands, why every page ships as Markdown for your favorite LLM, how it leans on Quarto for executable code blocks and tabbed install sections, and where it lands against Sphinx, MkDocs, and Zensical. Plus, you'll meet Tablin. Here we go. 
 
Episode sponsors 
 
<a href='https://talkpython.fm/sentry'>Sentry Error Monitoring, Code talkpython26</a>
<a href='https://talkpython.fm/temporal'>Temporal</a>
<a href='https://talkpython.fm/training'>Talk Python Courses</a> 
 
<h2 class="links-heading mb-4">Links from the show</h2>
<div>Guests 
Michael Chow: <a href="https://github.com/machow?featured_on=talkpython" target="_blank" >github.com</a> 
Rich lannone: <a href="https://github.com/rich-iannone?featured_on=talkpython" target="_blank" >github.com</a> 
 
Python Web Security with OWASP Top 10 and Agentic AI Course: <a href="https://talkpython.fm/ai-web-security" target="_blank" >talkpython.fm</a> 
 
GT: <a href="https://posit-dev.github.io/great-tables/articles/intro.html?featured_on=talkpython" target="_blank" >posit-dev.github.io</a> 
Episode: <a href="https://talkpython.fm/episodes/show/492/great-tables" target="_blank" >talkpython.fm</a> 
Sphinx: <a href="https://www.sphinx-doc.org/en/master/?featured_on=talkpython" target="_blank" >www.sphinx-doc.org</a> 
mkdocs: <a href="https://www.mkdocs.org/?featured_on=talkpython" target="_blank" >www.mkdocs.org</a> 
Zensical: <a href="https://zensical.org/?featured_on=talkpython" target="_blank" >zensical.org</a> 
Hugo: <a href="https://gohugo.io/?featured_on=talkpython" target="_blank" >gohugo.io</a> 
Ghost: <a href="https://ghost.org/?featured_on=talkpython" target="_blank" >ghost.org</a> 
Rs pkgdown: <a href="https://pkgdown.r-lib.org/?featured_on=talkpython" target="_blank" >pkgdown.r-lib.org</a> 
Quarto: <a href="https://quarto.org/?featured_on=talkpython" target="_blank" >quarto.org</a> 
quickstart: <a href="https://posit-dev.github.io/great-docs/user-guide/quickstart.html?featured_on=talkpython" target="_blank" >posit-dev.github.io</a> 
llms.txt file: <a href="https://llmstxt.org/?featured_on=talkpython" target="_blank" >llmstxt.org</a> 
llms.txt: <a href="https://talkpython.fm/llms.txt" target="_blank" >talkpython.fm</a> 
mcp: <a href="https://talkpython.fm/ai-integration" target="_blank" >talkpython.fm</a> 
cli: <a href="https://talkpython.fm/blog/posts/talk-python-now-has-a-cli/" target="_blank" >talkpython.fm</a> 
 
Watch this episode on YouTube: <a href="https://www.youtube.com/watch?v=rj2hY2Bsi30" target="_blank" >youtube.com</a> 
Episode #549 deep-dive: <a href="https://talkpython.fm/episodes/show/549/great-docs#takeaways-anchor" target="_blank" >talkpython.fm/549</a> 
Episode transcripts: <a href="https://talkpython.fm/episodes/transcript/549/great-docs" target="_blank" >talkpython.fm</a> 
 
Theme Song: Developer Rap 
🥁 Served in a Flask 🎸: <a href="https://talkpython.fm/flasksong" target="_blank" >talkpython.fm/flasksong</a> 
 
---== Don't be a stranger ==--- 
YouTube: <a href="https://talkpython.fm/youtube" target="_blank" > youtube.com/@talkpython</a> 
 
Bluesky: <a href="https://bsky.app/profile/talkpython.fm" target="_blank" >@talkpython.fm</a> 
Mastodon: <a href="https://fosstodon.org/web/@talkpython" target="_blank" > @talkpython@fosstodon.org</a> 
X.com: <a href="https://x.com/talkpython" target="_blank" > @talkpython</a> 
 
Michael on Bluesky: <a href="https://bsky.app/profile/mkennedy.codes?featured_on=talkpython" target="_blank" >@mkennedy.codes</a> 
Michael on Mastodon: <a href="https://fosstodon.org/web/@mkennedy" target="_blank" > @mkennedy@fosstodon.org</a> 
Michael on X.com: <a href="https://x.com/mkennedy?featured_on=talkpython" target="_blank" > @mkennedy</a> </div>

Podurama

Home

Trending

Personal

Your Podcasts

New Episodes

My Files

Favourite Episodes

Tags (Folders)

Recently Played

Bookmarks

Followed Playlists

#549: Great Docs

Talk Python To Me

AI Chapters

AI Insights

Reviews