I'd Rather Be Writing Podcast-logo

I'd Rather Be Writing Podcast

Technology Podcasts

A technical writing podcast about the latest trends and practices in the field of technical communication. Technical communication includes topics like technical writing (software help), information architecture, usability, API documentation, information design, web design, illustration, DITA, structured authoring, visual communication, and more. If you're a technical writer or interested in technical writing, this is the one of few podcasts in this niche. I also have a blog at https://idratherbewriting.com where the podcasts and other blog topics are published.

A technical writing podcast about the latest trends and practices in the field of technical communication. Technical communication includes topics like technical writing (software help), information architecture, usability, API documentation, information design, web design, illustration, DITA, structured authoring, visual communication, and more. If you're a technical writer or interested in technical writing, this is the one of few podcasts in this niche. I also have a blog at https://idratherbewriting.com where the podcasts and other blog topics are published.

Location:

United States

Description:

A technical writing podcast about the latest trends and practices in the field of technical communication. Technical communication includes topics like technical writing (software help), information architecture, usability, API documentation, information design, web design, illustration, DITA, structured authoring, visual communication, and more. If you're a technical writer or interested in technical writing, this is the one of few podcasts in this niche. I also have a blog at https://idratherbewriting.com where the podcasts and other blog topics are published.

Twitter:

@tomjohnson

Language:

English

Contact:

408-781-2129


Episodes

Podcast about Archbee -- a new documentation tool with a block-based editor, API publishing capability, content re-use, and more

10/31/2022
Archbee is a relatively new documentation tool that offers a block-based editor, API publishing capability, content re-use, and more. The initial version of Archbee was released in early 2019. Since then, the product has been steadily ramping up in features and growing its customer base. In this podcast, I chat with Claudiu Dascalescu about Archbee, the features driving its adoption, their target audience, and more.

Duration:00:29:09

Keynote presentation to STC India 2022

3/26/2022
This post is part of a series that explores tech comm trends that I've either followed or forgotten, and why. The overall goal is to better understand the reasons that drive trend adoption or abandonment in my personal career. This post contains a keynote presentation I gave to STC India on March 26, 2022.

Duration:00:57:10

[Podcast] Become a technical writer: conversation with Bobby Kennedy about the technical writing courses he offers

2/21/2022
I recently chatted with Bobby Kennedy to learn more about the technical writing courses he's offering at becometechnicalwriter.com. In this podcast, he shares a bit about why he started offering technical writing courses, some of the activities and strategies in the courses, and the outcomes so far.

Duration:00:29:50

MEGAComm recording: How to increase awareness of tech comm inside corporate walls

2/10/2022
I recently gave a presentation called How to increase awareness of tech comm inside corporate walls at the MEGAComm 2022 conference, which is a conference for tech comm professionals in Israel. The recording, slides, and description of my presentation are available below.

Duration:00:52:23

Presentation recording -- 'Best practices in API docs: Product overviews and getting started tutorials'

10/29/2021
I recently gave an online presentation about product overviews and getting started tutorials in API docs, sponsored by the STC Washington, D.C.-Baltimore Chapter. This post provides a recording of the presentation and related details.

Duration:01:01:32

tcworld China 2021 keynote: 'Tech comm and marketing: How to make your tech comm group more visible to those within your company'

9/16/2021
I recently gave a keynote presentation at tcworld China 2021 on the topic of tech comm and marketing. This post provides a recording of the presentation, slides, and detailed notes for the presentation.

Duration:01:10:42

Recording of 'Product overviews vs. getting started tutorials: striking a balance between read-first and try-first user behaviors'

8/7/2021
I recently gave a webinar to tekom Europe about product overviews and getting started tutorials. The recording and slides are below.

Duration:00:53:54

Videocast: Micro content and Flare -- Conversation with Kate Schneider

3/21/2021
In this videocast, I chat with Kate Schneider about micro content and Flare. Kate shares micro content examples from her current documentation and explains the strategies she considers when creating micro content. She shows specifically how to leverage analytics in determining micro content topics.

Duration:00:36:25

The story behind Document360 -- podcast with founder Saravana Kumar

11/17/2020
In a previous post, I explored how Document360, a new cloud-based documentation platform, handles API documentation scenarios. This time, I decided to record a podcast with Saravana Kumar, founder of Document360, to get the behind-the-scenes story about how Document360 came about, what's driving their fast pace of development, and their roadmap for the future.

Duration:00:36:39

Playing a product design role as a content designer -- podcast with Jonathon Colman

8/24/2020
In this podcast, I chat with Jonathon Colman about an innovative work model they implemented at Intercom with content designers. In their experimental model, content designers were allocated to one project only, and they expanded their roles to include not only content design but product design as well. These content/product designers engaged on a deeper level to help products succeed.

Duration:00:47:26

A tip for doc reviews -- bring a list of questions

7/24/2020
Although doc reviews are a central part of the tech writing process, it's often a challenge to get teams to review docs. One tip is to bring a list of questions to the doc review. This provides more structure and focus to the review meeting.

Duration:00:29:44

Writing productivity tip: Focus sessions

7/12/2020
I'm trying out a new writing productivity tip that seems to be working fairly well for me: focus sessions. A writing focus session is a one-hour session focused on a writing task. I made a goal last week of doing four writing focus sessions (at work) each day. I figured I should at least be able to devote half of my work day as a professional technical writer doing writing. This technique has boosted my writing productivity recently.

Duration:00:09:07

Developer portal strategies for complex landscapes -- conversation with Kristof van Tomme

6/24/2020
Recently I chatted with Kristof van Tomme, CEO and co-founder of Pronovix, about a topic that's become increasingly relevant in the past several months: how to deal with complex, rapidly evolving landscapes. Specifically, we focus on developer portal strategies that involve finding a balance between constraints and flexibility. Too many constraints reduces your ability to adapt to uncertain changes that might require innovative, unknown solutions. Too much flexibility might not lead to any...

Duration:02:58:35

API the Docs recording: How Trends in API Documentation Differ from other Tech Comm Trends

6/4/2020
I recently presented a session at the API the Docs virtual series on Wednesday, May 27, 2020, as part of the 5th edition. My session covered dev doc trends, and another session covered API design. A recording of my presentation is available below.

Duration:00:45:01

WTD Australia event recording -- 'Remote discussion: Techcomm in the times of pandemic'

5/31/2020
I recently co-presented in a WTD Australia event titled Techcomm in the times of pandemic on May 28, 2020. The other presenter was professor Kirk St. Amant. A recording is available below.

Duration:01:10:47

Are technical writers increasingly playing non-technical roles? Some thoughts on the evolution of technical writing roles

3/30/2020
How is the role of the technical writer evolving? It seems we're moving away from writing and more towards other roles, such as reviewer/convener, user champion, editor, publisher, and promoter. However, it's difficult to gauge change, especially across different job categories. In some scenarios, writing might never have been why we were hired.

Duration:00:33:12

Podcast: Users as producers of knowledge -- conversation with Nupoor Ranade about how tech writer roles are changing

3/29/2020
How can users shape and influence the documentation you're producing? In this podcast, I chat with Nupoor Ranade, PhD candidate at North Carolina State University, about how the roles of technical writers are changing. Instead of writers authoring content for passive users, users are actively directing and shaping the knowledge that writers produce. In this podcast, we look at ways docs-as-code workflows are facilitating that shift in roles. This podcast is more of a conversation, where I...

Duration:00:58:49

Webinar recording: How Trends in API Documentation Differ from other Tech Comm Trends

3/12/2020
I recently gave a webinar on trends in developer docs to the STC Washington DC chapter on March 12, 2020. In this presentation, I presented the results and analysis of my Trends in Developer Documentation 2020 survey. A recording and audio file is available below.

Duration:00:35:13

Introduction to API documentation - Recording from Los Angeles API documentation workshop

3/11/2020
In January I gave an API documentation workshop in Los Angeles, and I recorded the first section of the workshop. This section provides an introduction to APIs, including an overview of APIs, the API doc market, info about API popularity, how to submit requests through Postman, and other trends. The recording is available as both a video/audio or standalone audio.

Duration:01:35:58

Podcast: How Paligo is filling a niche in the CCMS market for complex documentation, with Anders Svensson

3/9/2020
I recently chatted with Anders Svensson about how Paligo, a cloud-based CCMS, is filling a niche in the CCMS market for complex documentation needs. Complex documentation refers to documentation with multiple product variants, versions, languages, audiences, and more. In these scenarios, content re-use and scalability become more challenging. Paligo is filling a need for documentation teams that have grown beyond their help authoring tools and need the more robust support that a component...

Duration:01:09:39