Great Docs - Talk Python to Me Ep. 549
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.
▬▬▬▬ About the podcast ▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
This video is the uncut, live recording of the Talk Python To Me podcast ( https://talkpython.fm ). We cover Python-focused topics every week and publish the edited and polished version in audio form. Subscribe in your podcast player of choice (100% free) at https://talkpython.fm/subscribe.
▬▬▬▬ Guests ▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
Michael Chow
Rich lannone
▬▬▬▬ Links and resources from the show ▬▬▬▬▬▬▬▬▬▬▬▬
Python Web Security with OWASP Top 10 and Agentic AI Course: /ai-web-security
Great Docs: https://posit-dev.github.io/great-docs/
Great Tables: https://posit-dev.github.io/great-tables/articles/intro.html
GT Episode: https://talkpython.fm/episodes/show/492/great-tables
Sphinx: https://www.sphinx-doc.org/en/master/
mkdocs: https://www.mkdocs.org/
Zensical: https://zensical.org/
Hugo: https://gohugo.io/
Ghost: https://ghost.org/
Rs pkgdown: https://pkgdown.r-lib.org/
Quarto: https://quarto.org/
quickstart: https://posit-dev.github.io/great-docs/user-guide/quickstart.html
llms.txt file: https://llmstxt.org/
llms.txt: https://talkpython.fm/llms.txt
mcp: https://talkpython.fm/ai-integration
cli: https://talkpython.fm/blog/posts/talk-python-now-has-a-cli/
▬▬▬▬ Dive deeper ▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
Listen to the Talk Python To Me podcast at https://talkpython.fm and explore over 275 hours of Python courses at https://training.talkpython.fm/courses.
▬▬▬▬ Follow us on Social ▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
Mastodon: Michael - https://fosstodon.org/@mkennedy & Talk Python - https://fosstodon.org/@talkpython
Bluesky: Michael - https://bsky.app/profile/mkennedy.codes & Talk Python - https://bsky.app/profile/talkpython.fm
X: Michael - https://x.com/mkennedy & Talk Python - https://x.com/talkpython
▬▬▬▬ About the podcast ▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
This video is the uncut, live recording of the Talk Python To Me podcast ( https://talkpython.fm ). We cover Python-focused topics every week and publish the edited and polished version in audio form. Subscribe in your podcast player of choice (100% free) at https://talkpython.fm/subscribe.
▬▬▬▬ Guests ▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
Michael Chow
Rich lannone
▬▬▬▬ Links and resources from the show ▬▬▬▬▬▬▬▬▬▬▬▬
Python Web Security with OWASP Top 10 and Agentic AI Course: /ai-web-security
Great Docs: https://posit-dev.github.io/great-docs/
Great Tables: https://posit-dev.github.io/great-tables/articles/intro.html
GT Episode: https://talkpython.fm/episodes/show/492/great-tables
Sphinx: https://www.sphinx-doc.org/en/master/
mkdocs: https://www.mkdocs.org/
Zensical: https://zensical.org/
Hugo: https://gohugo.io/
Ghost: https://ghost.org/
Rs pkgdown: https://pkgdown.r-lib.org/
Quarto: https://quarto.org/
quickstart: https://posit-dev.github.io/great-docs/user-guide/quickstart.html
llms.txt file: https://llmstxt.org/
llms.txt: https://talkpython.fm/llms.txt
mcp: https://talkpython.fm/ai-integration
cli: https://talkpython.fm/blog/posts/talk-python-now-has-a-cli/
▬▬▬▬ Dive deeper ▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
Listen to the Talk Python To Me podcast at https://talkpython.fm and explore over 275 hours of Python courses at https://training.talkpython.fm/courses.
▬▬▬▬ Follow us on Social ▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
Mastodon: Michael - https://fosstodon.org/@mkennedy & Talk Python - https://fosstodon.org/@talkpython
Bluesky: Michael - https://bsky.app/profile/mkennedy.codes & Talk Python - https://bsky.app/profile/talkpython.fm
X: Michael - https://x.com/mkennedy & Talk Python - https://x.com/talkpython
