RDoc is the backbone of Ruby's documentation: it powers docs.ruby-lang.org, the ri command-line tool, and user gem's API docs. But it hasn't kept up with modern Ruby, modern Markdown, or the way developers (and AI agents) now consume documentation.

Over the past two years, we've rebuilt significant parts of it: a new Prism-based parser, a new default theme called Aliki, better Markdown support, RBS type signatures in HTML and ri, and a live-preview server. All of these have shipped or are coming in RDoc 8.0.

This talk covers what we built, and what's still ahead — especially why Ruby documentation has to work for AI too.