Lorna Mitchell: Writing Documentation Engineers Will Actually Read

More from Maintainable All episodes →

1. 

   E202 · 18 Mar 2025 · 41 min

   Heimir Thor Sverrisson: Architecture First, Tech Debt Second

   Sustainable software starts with sustainable architecture. Heimir Thor Sverrisson joins Robby to discuss why poor architectural decisions make maintenance a losing battle, how technical debt should be managed, and why adding more CPUs won’t always fix your performance problems.

2. 

   E201 · 11 Mar 2025 · 42 min

   Noémi Ványi: Only Fix Problems That Are Actually Problems

   Not every messy piece of code needs a refactor. Noémi Ványi joins Robby to discuss how to decide when technical debt is worth paying down, why developer autonomy matters, and how intuition plays a key role in software sustainability.

3. 

   E200 · 25 Feb 2025 · 51 min

   Julia López: Code Tells a Story—Even the White Spaces

   What can legacy code tell us—beyond just functionality? Julia Lopez shares how even white spaces and variable names reveal a system’s history. She and Robby dive into mentoring, refactoring, and the realities of rewriting Harvest’s billing system.

4. 

   E199 · 18 Feb 2025 · 53 min

   Marty Haught: Rethinking Technical Debt—Is It Really Just Drift?

   Is "technical debt" really the best metaphor for aging software? Marty Haught suggests a better one—drift. He joins Robby to discuss how software naturally diverges from its original intent, the challenge of sustaining open-source projects, and what companies can do to support critical infrastructure like RubyGems.

5. 

   E198 · 11 Feb 2025 · 45 min

   Mike Bowers - From ISAM to JSON—Navigating 40+ Years of Database Evolution

   For over 40 years, FairCom has evolved its database technology from ISAM to high-performance JSON APIs. Mike Bowers, Chief Architect at FairCom, joins Robby to discuss the complexities of maintaining a legacy codebase while innovating for the future. What does it take to modernize without breaking everything?

6. 

   E196 · 21 Jan 2025 · 43 min

   Carola Lilienthal: Tackling Technical Debt with Patterns and Domain Knowledge

   What role do architecture, modularity, and domain knowledge play in reducing technical debt? Join Robby as he chats with Carola Lilienthal about designing maintainable software, using cognitive science to simplify systems, and the importance of patterns for sustainable development.

7. 

   E195 · 14 Jan 2025 · 46 min

   Joel Hawksley: The Hidden Costs of Frontend Complexity

   Joel Hawksley, Staff Software Engineer at GitHub, joins Robby to discuss the challenges of scaling frontend systems and ensuring accessibility across a massive platform. With over six years of experience at GitHub, Joel reflects on the evolution of their design system, Primer, the importance of changeability in software, and strategies for addressing the complexities of frontend maintenance.

8. 

   E194 · 10 Dec 2024 · 47 min

   Austin Story: Making Software Easier to Change, Remove, and Evolve

   What makes software maintainable and easy to evolve? Austin Story shares his approach to simplifying systems, migrating architectures, and fostering a culture of intentional development.

9. 

   E193 · 3 Dec 2024 · 49 min

   Dan Moore: Building Developer-Friendly Authentication Solutions

   What makes software maintainable in the long run? Robby chats with Dan Moore, Principal Product Engineer at FusionAuth, about legacy systems, developer empathy, and the balance between SaaS and self-hosted solutions. Dan Moore, Principal Product Engineer at FusionAuth, shares his journey through legacy systems, building authentication tools, and fostering developer empathy. With 25 years of experience, Dan sheds light on improving software maintainability and the evolving challenges in the industry.

10. 

    E192 · 26 Nov 2024 · 43 min

    Tom Johnson: From Auto-Documentation to Better Collaboration

    Tom Johnson shares his journey of tackling complex distributed systems, the challenges of managing technical debt, and how tools like Multiplayer are revolutionizing auto-documentation and debugging.