{"podcast":{"title":"The Bike Shed","slug":"the-bike-shed","podcast_index_feed_id":1093676,"rss_url":"https://feeds.fireside.fm/bikeshed/rss","website_url":"https://bikeshed.thoughtbot.com","image_url":"https://media24.fireside.fm/file/fireside-images-2024/podcasts/images/1/167c01a1-0eb9-4640-b488-c2f6d6866650/cover.jpg?v=6","author":"thoughtbot","episode_count":504,"summary":"On The Bike Shed, hosts Joël Quenneville, Sally Hall, and Aji Slater discuss development experiences and challenges at thoughtbot with Ruby, Rails, JavaScript, and whatever else is drawing their attention, admiration, or ire this week.","last_synced_at":"2026-07-01T04:21:12.552548+00:00","page_url":"https://stenobird.com/podcast/the-bike-shed"},"episode":{"title":"501: What makes for good technical writing?","slug":"501-what-makes-for-good-technical-writing","published_at":"2026-06-02T14:00:00+00:00","page_url":"https://stenobird.com/podcast/the-bike-shed/501-what-makes-for-good-technical-writing","show_page_url":"https://stenobird.com/podcast/the-bike-shed","url":"https://bikeshed.thoughtbot.com/501","audio_url":"https://aphid.fireside.fm/d/1437767933/167c01a1-0eb9-4640-b488-c2f6d6866650/00dbe12b-8697-4ebc-a7c3-974fb4cce506.mp3","summary":"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","meta_description":"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 term…","key_points":[],"chapters":[],"topics":[],"duration_seconds":2067,"processing_state":"not_requested","actions":[{"name":"request_transcript","method":"POST","url":"https://stenobird.com/v1/public/podcasts/the-bike-shed/episodes/501-what-makes-for-good-technical-writing/transcription-requests","description":"Idempotently request low-priority transcript generation for this episode."},{"name":"read_markdown","method":"GET","url":"https://stenobird.com/podcast/the-bike-shed/501-what-makes-for-good-technical-writing.md","description":"Read the agent-friendly Markdown representation of this episode resource."}]}}