Demystifying the Rails Codebase with Ridhwana Khan - RUBY 675

About this episode

The episode features an interview with Ridhwana Khan discussing Ruby on Rails documentation and her journey in technical writing.

Hey folks, in this week’s episode, I sat down with the incredible Ridhwana Khan — a South African technical writer for the Rails Foundation and lead engineer at Circle. We had a fantastic chat about all things Ruby on Rails, but especially the underappreciated art (and science!) of writing documentation. Ridhwana took us behind the scenes of the official Rails Guides — how they’re updated, expanded, and reviewed — and gave us a real sense of the thoughtful, collaborative work that powers one of the best-documented frameworks out there. She also shared her personal journey: from freelancing into Rails doc writing, to her passion for building inclusive communities like Rails Girls South Africa and Black Girls Code. Some standout takeaways: Metaprogramming = Superpower: We talked about the "magic" in Rails internals — especially metaprogramming — and how understanding it can make you a better developer. Ridwana gave a real-world use case from her time at Dev.to where metaprogramming enabled highly flexible custom profile fields. Elegant and practical! Docs as a Gateway to Contribution: Whether you're new or experienced, contributing to Rails docs is a great way to get involved…

People in this episode

Host: Charles M Wood

Guest: Ridhwana Khan

Topics covered

• Ruby on Rails
• documentation
• metaprogramming
• inclusive communities
• contribution
• technical writing

Keywords

• Ruby on Rails
• documentation
• metaprogramming
• Rails Guides
• contribution
• technical writing
• inclusive communities
• Circle

Mentioned in this episode

Organizations: Rails Foundation, Circle, Rails Girls South Africa, Black Girls Code, Dev.to

More episodes of Ruby Rogues

• Autogenetic AI Agents and the Future of Ruby Development - RUBY 682 · December 24, 2025 · 1h 1m
• The New Era of Rails: Markdown, Offline Mode, and Smarter Dev Tools - RUBY 681 · November 23, 2025 · 35 min
• Keeping Ruby Welcoming: A Conversation We Need to Have - RUBY 680 · November 14, 2025 · 42 min
• Inside the RubyGems Controversy: Transparency, Trust, and the Future of Ruby Central - RUBY 679 · November 1, 2025 · 51 min
• Distributing Your CLI with Homebrew: Tips from Mike McQuaid - RUBY 678 · September 9, 2025 · 1h 12m
• Indexing the Ruby World with RubyEvents.org - RUBY 677 · July 16, 2025 · 1h 12m