
I'd Rather Be Writing
366 FOLLOWERS
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..
I'd Rather Be Writing
2M ago
In this post, I continue the series on systems thinking as I describe my experience in writing a documentation project plan for a large project involving multiple APIs. I argue that we should look at how APIs interact as a network rather than just documenting each API as a standalone part ..read more
I'd Rather Be Writing
3M ago
In this podcast, I chat with Adam Altman all about Redocly, an authoring/publishing tool for creating API documentation. Topics we discuss include why he started Redocly, the approach to API doc tools, what explains the continued popularity of Redocly, the docs-as-code approach to API tooling, and more ..read more
I'd Rather Be Writing
7M ago
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 ..read more
I'd Rather Be Writing
1y ago
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 ..read more
I'd Rather Be Writing
1y ago
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 ..read more
I'd Rather Be Writing
1y ago
I recently gave a presentation called How to increase awareness of tech comm inside corporate walls at the Megacomm conference, which is a conference for tech comm professionals in Israel. The recording, slides, and description of my presentation is available below ..read more
I'd Rather Be Writing
1y ago
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 ..read more
I'd Rather Be Writing
1y ago
I recently gave a keynote presentation at tcworld China 2021 on the topic of tech comm and marketing. This is a recording of the presentation, slides, and detailed notes for the presentation ..read more
I'd Rather Be Writing
1y ago
I recently gave a presentation to tekom Europe about product overviews and getting started tutorials. The recording and slides are below ..read more
I'd Rather Be Writing
2y ago
I recently appeared on the Knowledgebase Ninjas podcast in an episode titled Metrics Don't Work. In the podcast, I chat with Gowri Ramkumar about documentation processes, why metrics are problematic, advantages and disadvantages of docs-as-code models, why measuring doc traffic falls short, the value of internal documentation, people I've learned from in my career, advice for my younger self, and more ..read more