The Bike Shed

489: What makes a codebase welcoming

The Bike Shed

Show Notes

Joël and Sally tidy up the place as they discuss the different ways a new codebase and team can feel welcoming to them.

Together they break down the things that help them ingrate into a new project more easily, explain why the lore of a project can be sacred to some, what you can do in the present to make things easier for a developer down the road, and why communication is crucial for keeping everyone on the same page even long after you’ve moved on.

—

Check out these resources for a deeper dive into some of the topics mentioned in this week’s episode - Fixtures - Hierarchy of Documentation - Domain Modelling 1 - Domain Modelling 2

Thanks to our sponsor for this episode Scout Monitoring.

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

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 →