489: What makes a codebase welcoming

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: hosts@bikeshed.fm This has been a thoughtbot podcast. Stay up to date by following us on social media - YouTube - LinkedIn - Mastodon - BlueSky © 2026 thoughtbot, inc.

You can listen to 489: What makes a codebase welcoming online on Radio and Podcast. Open the player on this page to stream the available audio.

489: What makes a codebase welcoming is an episode from The Bike Shed by thoughtbot.

This episode is 39:13 long.

This episode was published on Jan 13, 2026.

Yes. Use the heart button on the episode page to add it to your favorite episodes list.

Yes. This page shows related episodes from The Bike Shed when more episodes are available from the podcast feed.