Beyond 'parts' documentation: Moving towards systems thinking with developer portals
I'd Rather Be Writing
by Tom Johnson
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
Visit website
Podcast: All about Redocly, with founder Adam Altman
I'd Rather Be Writing
by Tom Johnson
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
Visit website
Podcast about Archbee -- a new documentation tool with a block-based editor, API publishing capability, content re-use, and more
I'd Rather Be Writing
by Tom Johnson
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
Visit website
Trends to follow or forget presentation to STC India
I'd Rather Be Writing
by Tom Johnson
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
Visit website
[Podcast] Become a technical writer: conversation with Bobby Kennedy about the technical writing courses he offers
I'd Rather Be Writing
by Tom Johnson
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
Visit website
Megacomm recording: How to increase awareness of tech comm inside corporate walls
I'd Rather Be Writing
by Tom Johnson
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
Visit website
Presentation recording -- 'Best practices in API docs: Product overviews and getting started tutorials'
I'd Rather Be Writing
by Tom Johnson
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
Visit website
Tcworld China 2021 keynote: 'Tech comm and marketing: How to make your tech comm group more visible to those within your company'
I'd Rather Be Writing
by Tom Johnson
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
Visit website
Recording of 'Product overviews vs. getting started tutorials: striking a balance between read-first and try-first user behaviors'
I'd Rather Be Writing
by Tom Johnson
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
Visit website
My Knowledgebase Ninjas podcast episode -- "Metrics don't work"
I'd Rather Be Writing
by Tom Johnson
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
Visit website

Follow I'd Rather Be Writing on Feedspot

Continue with Google
Continue with Apple
OR