The Bike Shed

501: What makes for good technical writing?

The Bike Shed

Show Notes

Sally and Joël get technical as they lay out their thoughts on blog posts.

Our hosts pick apart what makes a good technical blog post, why consistent terms are more important than you might think when communicating with your audience, and how to improve your own writing to ensure your reader remains engaged.

—

There’s still time to secure your place at thoughtbot’s upcoming UK meet ups over the next month.

London Tech Leader Meetup - Tuesday June 23rd

Brighton Tech Leader Meetup - Wednesday June 24th

Brighton Ruby - Thursday June 25th

Evolve - Friday June 26th

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 →