The Bike Shed

497: Diagrams we love

The Bike Shed

Show Notes

Aji and Joël get into a flow as they discuss the different diagrams that help guide their thought processes when working.

Together they compare their go to diagrams and why they find them so useful, the different analysis tools a diagram can offer and the alternative perspective on your work it provides, as well as how using diagrams can help communicate your mental models more effectively with your colleagues.

—

Be sure to check out these resources on diagrams and conditionals for some wider reading on today’s episode - BeautifulMermaid Repo - Visualising RSepc - Structuring Conditionals

You can also find our hosts speaking at various conferences over the next few months - Haggis Ruby - Blue Ridge Ruby

Your hosts for this episode have been thoughtbot’s own Joël Quenneville and Aji Slater.

If you would like to support the show, head over to our GitHub page, or check out our website.

Got a question or comment about the show? Why not write to our hosts: [email protected]

This has been a thoughtbot podcast.

Stay up to date by following us on social media - YouTube - LinkedIn - Mastodon - BlueSky

© 2026 thoughtbot, inc. Support The Bike Shed

More from The Bike Shed

Oct 13, 2026

Debt metaphors abound! In this week’s episode of The Bike Shed, Aji and Joel ponder the question, what are risks in a code base?

Oct 6, 2026

Joël takes Bike Shed out onto the conference floor at RailsWorld as he interviews programer and streamer Rachael Wright-Munn, aka ChaelCodes.

Sep 29, 2026

In this week’s episode of The Bike Shed, Aji and Joël dive into the distrust around the phrase ‘programmer discipline’, why you cannot just rely on willpower, and how Static Analysis tools can help with not crossing boundaries.

Sep 15, 2026

The Bike Shed is BACK! Aji and Joel kick off this week’s episode with a fantastic combination of component bugs and how much headspace they take up, historic heraldry vs ChatGPT’S anchoring bias, before diving into the latest big development of the Dev world, Github’s release of stacked PR’s.

Jul 14, 2026

It’s time to play the music, it’s time to… get Aji and Sally together again. This week’s episode is a radical one, and a listener suggestion no less; let’s Muppet-cast a software development team!

See all episodes →