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 (https://api.rubyonrails.org/v3.1/classes/ActiveRecord/Fixtures.html) - Hierarchy of Documentation (https://challahscript.com/hiearchy_of_documentation) - Domain Modelling 1 (https://martinfowler.com/bliki/AnemicDomainModel.html) - Domain Modelling 2 (https://thoughtbot.com/blog/avoid-putting-logic-in-map-blocks) Thanks to our sponsor for this episode Scout Monitoring (https://www.scoutapm.com/). Your hosts for this episode have been thoughtbot’s own Joël Quenneville (https://www.linkedin.com/in/joel-quenneville-96b18b58/) and Sally Hall (https://www.linkedin.com/in/sallyannahall). If you would like to support the show, head over to our GitHub page (https://github.com/sponsors/thoughtbot), or check out our website (https://bikeshed.thoughtbot.com). Got a question or comment about the show? Why not write to our hosts: hosts@bikeshed.fm This has been a thoughtbot (https://thoughtbot.com/) podcast. Stay up to date by following us on social media - YouTube (https://www.youtube.com/@thoughtbot/streams) - LinkedIn (https://www.linkedin.com/company/150727/) - Mastodon (https://thoughtbot.social/@thoughtbot) - BlueSky (https://bsky.app/profile/thoughtbot.com) © 2026 thoughtbot, inc.