Great Docs: The Future of Documentation | The Python Exchange June 2026
About the Python Exchange for the Department of Energy: https://meetup.doepy.org/
Sign up here to be notified when the next Python Exchange is scheduled: https://bit.ly/py-exchange
Guest Panelist: Rich Iannone
Title: Great Docs: Building the Documentation Site Generator I Always Wanted
Bio: Rich Iannone
Rich is a software engineer and someone who cares a great deal about documentation and summary tables. He's been working on table presentation and documentation packages for quite a long time, and nobody has told him to stop yet, so he's still on top of all that. He started off mostly creating open-source packages in R, but more lately, he's been doing open-source things in Python. Rich really enjoys creating all these packages because he realizes that people can use 'em to do great things in their own work.
Abstract:
Documentation generators have, for me, been a thing where there are so many trade-offs. They might make beautiful sites, but be shallow feature-wise. Or full of features but really hard to configure. After some years of working across R, Python, and the broader open-source ecosystem, I started Great Docs with a simple end goal: your docs should look really great, be easy to discover, and be ready for the AI era.
In this presentation, I will walk through the various places I drew inspiration for Great Docs (pkgdown, MATLAB, Elixir, and the Vue.js docs). I'll show how Great Docs makes documentation consumable by both humans and AI agents through Skills and MCP server documentation. I'll share some of the features I obsessively built because I wanted them in my own package docs. Finally, I'll discuss where this project is headed beyond Python (toward documenting CLIs, TUIs, and more).
At Don't Use This Code, we want to create a unique opportunity to see Python succeed and thrive within the DOE. In collaboration with an organizing committee of Python users and advocates from various DOE sites, we host regular conversations on the topic of Python in order to create a new resource for scientists, researchers, and technical staff. Our goal is to share best practices and build a strong, lasting community for Python users within the Department of Energy National Lab system.
If you, or someone you know, might make a great panelist, we'd love to get in touch! Just send us an email at DOEPy@dutc.io if you would like to participate or have any questions.
Sign up here to be notified when the next Python Exchange is scheduled: https://bit.ly/py-exchange
Guest Panelist: Rich Iannone
Title: Great Docs: Building the Documentation Site Generator I Always Wanted
Bio: Rich Iannone
Rich is a software engineer and someone who cares a great deal about documentation and summary tables. He's been working on table presentation and documentation packages for quite a long time, and nobody has told him to stop yet, so he's still on top of all that. He started off mostly creating open-source packages in R, but more lately, he's been doing open-source things in Python. Rich really enjoys creating all these packages because he realizes that people can use 'em to do great things in their own work.
Abstract:
Documentation generators have, for me, been a thing where there are so many trade-offs. They might make beautiful sites, but be shallow feature-wise. Or full of features but really hard to configure. After some years of working across R, Python, and the broader open-source ecosystem, I started Great Docs with a simple end goal: your docs should look really great, be easy to discover, and be ready for the AI era.
In this presentation, I will walk through the various places I drew inspiration for Great Docs (pkgdown, MATLAB, Elixir, and the Vue.js docs). I'll show how Great Docs makes documentation consumable by both humans and AI agents through Skills and MCP server documentation. I'll share some of the features I obsessively built because I wanted them in my own package docs. Finally, I'll discuss where this project is headed beyond Python (toward documenting CLIs, TUIs, and more).
At Don't Use This Code, we want to create a unique opportunity to see Python succeed and thrive within the DOE. In collaboration with an organizing committee of Python users and advocates from various DOE sites, we host regular conversations on the topic of Python in order to create a new resource for scientists, researchers, and technical staff. Our goal is to share best practices and build a strong, lasting community for Python users within the Department of Energy National Lab system.
If you, or someone you know, might make a great panelist, we'd love to get in touch! Just send us an email at DOEPy@dutc.io if you would like to participate or have any questions.
