I'd Rather Be Writing Podcast
Latest Episodes
Podcast: Spec-driven Development of REST APIs, with a focus on RAML — interview with Michael Stowe
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
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
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
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
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
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’
Introduction to technical writing — slides and audio recording
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
Recording and slides from "Jekyll vs. DITA: Bridging the Gap Between Tech Comm and the Web" presentation
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
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
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