You can view the new Write the Docs podcast here: podcast.writethedocs.org. I’m one of the co-hosts, along with Jared Morgan, Carlee Potter, and Chris Ward. Jared and Carlee are based in Australia, and Chris is in Berlin (though he’s English/Australian).
Here’s the first episode:
I felt there was a need for a discussion-based podcast similar to Leo Laporte’s This Week in Tech (TWIT), so I asked around on the Write the Docs #podcast Slack channel channel if others were interested. Jared, Carlee, and Chris all wanted to do a podcast too.
Although we’ll be the core co-hosts, we’re also planning to rotate in other WTD community members as well. Right now the podcast is in its early stages, and we have just one episode recorded.
The podcast is a group effort, with everyone pitching in, from the recording to the post-editing to the website and more.
I helped build the site, so I want to mention a few details here. To build the site, we started with this Soundcast HTML theme. I then converted it to Jekyll. The conversion to Jekyll is surprisingly simple. At some point I want to write a more detailed guide on how to convert a site to Jekyll, but basically converting an HTML site to Jekyll involves the following:
The most difficult part was modifying the HTML from the original theme to exclude all the layouts that we didn’t need or want.
The heart of any podcast site is the media RSS feed. You can see this feed at http://podcast.writethedocs.org/itunes.rss. The RSS feed is how you syndicate your site across different channels, such as iTunes and Stitcher.
The template for the media RSS feed is here. In some places, the template gets values stored in the _config.yml file.
The template also loops through the latest posts that have
podcasts as a category and inserts values from the frontmatter in those posts into the RSS feed automatically. You can see the frontmatter for the post here.
Enough of the technical details. I encourage you to subscribe in some form or another – whether iTunes, Stitcher, Pocketcast, Youtube, RSS, Email, or some other method. We hope to publish regular podcasts here, with at least a monthly cadence, if not more frequently.
Let us know if you have any topic requests or feedback.
Get new posts delivered straight to your inbox.
I'm a technical writer based in the California San Francisco Bay area. Topics I write about on this blog include technical writing, authoring and publishing tools, API documentation, tech comm trends, visual communication, technical writing career advice, information architecture and findability, developer documentation, and more. If you're a professional or aspiring technical writer, be sure to subscribe to email updates using the form above. You can learn more about me here. You can also contact me with questions.