The Bike Shed

489: What makes a codebase welcoming


Listen Later

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
View all episodesView all episodes
Download on the App Store

The Bike ShedBy thoughtbot

  • 4.9
  • 4.9
  • 4.9
  • 4.9
  • 4.9

4.9

121 ratings


More shows like The Bike Shed

View all
Radiolab by WNYC Studios

Radiolab

44,006 Listeners

Planet Money by NPR

Planet Money

30,811 Listeners

Marketplace by Marketplace

Marketplace

8,749 Listeners

Tentative by thoughtbot

Tentative

9 Listeners

The Changelog: Software Development, Open Source by Changelog Media

The Changelog: Software Development, Open Source

288 Listeners

Giant Robots Smashing Into Other Giant Robots by thoughtbot

Giant Robots Smashing Into Other Giant Robots

88 Listeners

Build Phase by thoughtbot

Build Phase

44 Listeners

Ruby Rogues by Charles M Wood

Ruby Rogues

45 Listeners

Software Engineering Daily by Software Engineering Daily

Software Engineering Daily

625 Listeners

Soft Skills Engineering by Jamison Dance and Dave Smith

Soft Skills Engineering

289 Listeners

Syntax - Tasty Web Development Treats by Wes Bos & Scott Tolinski - Full Stack JavaScript Web Developers

Syntax - Tasty Web Development Treats

988 Listeners

REWORK by 37signals

REWORK

213 Listeners

Crossroads by thoughtbot

Crossroads

2 Listeners

Remote Ruby by Chris Oliver, Andrew Mason

Remote Ruby

34 Listeners

Reboot by thoughtbot

Reboot

12 Listeners

Hard Fork by The New York Times

Hard Fork

5,531 Listeners

Shell Game by iHeartPodcasts and Kaleidoscope

Shell Game

1,120 Listeners

Complex Systems with Patrick McKenzie (patio11) by Patrick McKenzie

Complex Systems with Patrick McKenzie (patio11)

142 Listeners

The Pragmatic Engineer by Gergely Orosz

The Pragmatic Engineer

70 Listeners

Rails Business by Brendan Buckingham & Ryan Frisch

Rails Business

0 Listeners