501: What makes for good technical writing?

Episode 501 · June 2nd, 2026 · 34 mins 27 secs

About this Episode

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: 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.

Support The Bike Shed