| layout | news_post |
|---|---|
| title | A New Look for Ruby's Documentation |
| author | Stan Lo |
| translator | |
| date | 2025-12-23 00:00:00 +0000 |
| lang | en |
Following the ruby-lang.org redesign, we have more news to celebrate Ruby's 30th anniversary: docs.ruby-lang.org has a completely new look with Aliki—RDoc's new default theme.
Ruby has always been a joy to write, and now reading Ruby documentation can match that experience. Aliki brings a modern, clean design to docs.ruby-lang.org and any gem that generates documentation with RDoc v7.0+.
- Improved search: Case-aware ranking, fuzzy matching, and support for searching constants
- Dark mode: Respects your OS preference with a manual toggle
- Three-column layout: Left sidebar for navigation, center for content, right sidebar for table of contents
- Code block improvements: Copy buttons on code blocks and C syntax highlighting
- Customizable footer: Gem maintainers can add links to their repository, issue tracker, and other resources
If you generate documentation with RDoc 7.0+, your users will see Aliki automatically. You can customize footer links or switch back to the Darkfish theme in your .rdoc_options file.
See the new look in action at docs.ruby-lang.org.
If you find issues or have suggestions, please open an issue on GitHub.