The future of Ruby documentation
Ruby documentation is getting its biggest update in years. As an RDoc maintainer, I've spent the past year modernizing how we read Ruby docs. But improving the reading experience is just the beginning.
This year, I'm focusing on three major developments: migrating from RDoc markup to GitHub Flavored Markdown, integrating RBS type signatures directly into documentation, and preparing Ruby docs for the AI era with LLM-ready output formats and agent tooling.
This talk covers where Ruby documentation has been, where it's going, and the concrete roadmap for RDoc's evolution. Writing and consuming Ruby documentation is about to get a lot better.
-
Stan LoStan is a Ruby committer and maintains Ruby toolings like IRB, Reline, and RDoc. He is a member of Shopify's Ruby Developer Experience Team.