I'd Rather Be Writing Podcast

I'd Rather Be Writing Podcast


Latest Episodes

Podcast: Spec-driven Development of REST APIs, with a focus on RAML — interview with Michael Stowe
October 12, 2015

b {font-size:115%;} Note: If you're in the Bay area, come listen to Michael Stowe speak tonight (Monday, Oct 12) at the STC Silicon Valley chapter in Santa Clara. See the meeting details here. In this episode, I interview Michael Stowe, author of Undistu

Podcast: The divide between academics and practitioners — Interview with Lisa Meloncon
August 10, 2015

Here’s the audio for the podcast: You can download the MP3 file here. Podcast summary One common response I usually get with podcasts is that people want a transcript of the audio. Although I don’t have time to make a verbatim transcript, I decided to wr

Podcast: How do design, length, and relevance affect how people use API reference docs — interview with Bob Watson
July 30, 2015

Listen to the podcast You can download the MP3 file here</a>. Summary Bob was a software engineer for 17+ years. He decided to get a PhD from the University of Washington’s Human Centered Design and Engineering because he felt that if the documentat

Listen to Ed Marsh's Content Content podcast with me as a guest
July 08, 2015

If you like podcasts, check out episode 4 of Ed Marsh’s Content Content podcast. Ed talks with me at length about a variety of tech comm topics — everything from how I got into technical writing to publishing tools, DITA, Jekyll, Markdown, and more. Chat

The key to writing good documentation: Testing your instructions
July 07, 2015

testing_documentation 1.0 → The key to writing good documentation: Testing your instructions 1.1 Should QA test documentation? 1.2 Communicating feedback from testing documentation 1.3 Should technical writers care about more than documentation? 1.4 Shou

API Documentation presentation to East Bay STC chapter — slides and recording
May 16, 2015

The other week I gave a presentation on API documentation to the East Bay STC chapter. Here are the slides and recording. API Documentation presentation to East Bay STC Chapter from Tom Johnson Here’s the PowerPoint version of the slides. Here&#8217

Introduction to technical writing — slides and audio recording
May 16, 2015

A few weeks ago I gave a presentation to a small group of beginning technical writers in India. The presentation was a 20 minute introduction to technical writing, and I gave the presentation over Skype. Slides Here are the slides: Audio recording Here&#8

Recording and slides from "Jekyll vs. DITA: Bridging the Gap Between Tech Comm and the Web" presentation
May 15, 2015

Jekyll versus DITA 1.0 Check out Ed Marsh's podcast, and also My New series: Jekyll versus DITA 1.1 Authoring with Markdown in Jekyll versus Authoring with DITA in OxygenXML 1.2 Variables and conditional processing in Jekyll versus DITA 1.3 Creating re-u

Recording of API documentation workshop (REST and Javadoc) at tcworld India 2015
March 19, 2015

Here’s a recording of the API documentation workshop that I gave at tcworld India 2015: In this workshop, I cover the following: Overview of API documentation Deep Dive into REST API documentation Deep Dive into Javadoc API documentation This is sim

Recording of Innovation in Technical Communication keynote at tcworld India 2015
March 18, 2015

Innovation in tech comm 1.0 Sustaining and disruptive innovations 1.1 A long list of technical innovations semi-relevant to technical writers 1.2 The only significant innovation for tech comm 1.3 XML and the web: drifting farther apart? 1.4 The genius of