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. Ridwana encouraged folks to read the source code, dig into tests, and not be afraid to open a PR — even if it's small.
  
  
• Working on Circle: Ridwana’s team focuses on Circle's marketing and email hub features — think broadcasts, workflows, and analytics. She's leading the team (and hiring!), and we geeked out over async work, remote culture, and what makes for a great engineering org.
  
  
• Life in Cape Town: From houseplants to penguins, we veered off into Ridwana’s love of nature, her Arduino hobby projects, and even how Shark Week got us thinking about visiting South Africa someday.

This episode was equal parts inspiring and insightful — especially if you’ve ever looked at the Rails codebase and thought, “how the heck does this work?” Ridwana makes it feel accessible, and she’s proof that curiosity and community-building go a long way in tech.


Become a supporter of this podcast: https://www.spreaker.com/podcast/ruby-rogues--6102073/support.