@tomjohnson profile picture
Tom Johnson @tomjohnson

Technical writer, blogger, and podcaster. Interested in APIs, simplifying complexity, content strategy, information design, and more. #techcomm

Joined January 2007
  • Tweets 6,610
  • Following 2,381
  • Followers 5,580
174 Photos and videos
New post: "Using long-token contexts to quality check an entire API doc set." One of the advantages of recent Gen AI updates is the massive token input context. ... Read more: idbwrtng.com/long-token-cont… #ai #technicalwriting #documentation #ai

Using long-token contexts to quality check an entire API doc set

Stay updated with best practices for technical writers. Includes an API documentation course for technical writers and engineers learning how to document APIs. The course includes sections on what an...

idratherbewriting.com
5
545
New podcast: "Uncovering and communicating the value of your tech comm teams' work, with Keren Brown" Listen here: idbwrtng.com/value-techcomm-… #documentation #ai #techcomm #zoominsoftware #technicalwriting
1
560
New post: What should your documentation metrics look like? Q&A with Zoomin about their 2024 Technical Content Benchmark Report (Sponsored) Read more: idbwrtng.com/benchmark-repor… #techcomm #technicalwriting

What should your documentation metrics look like? Q&A with Zoomin about their 2024 Technical...

Zoomin recently released a Technical Content Benchmark Report for 2024. This report explains the company’s second benchmark report on documentation metrics, which analyzes data from 97.6 million user...

idratherbewriting.com
1
6
503
New post: "AI is accelerating my technical writing output, and other observations." AI is accelerating my technical writing output, making me about twice as productive as before.  Read more: idbwrtng.com/ai-is-accelerat… #techcomm #ai #technicalwriting #documentation

AI is accelerating my technical writing output, and other observations

At the start of the year, I wrote a trends post and noted uncertainty about the directions AI will take tech writers this year. (See My 2024 technical writing trends and predictions.) Now that we’re...

idratherbewriting.com
2
6
511
New post: "Integrating AI with your content delivery platform and documentation: Zoomin Q&A with Keren Brown." Read more: idbwrtng.com/zoomin-ai-integ… #ai #api #documentation #techcomm #technicalwriting @ZoominSoftware
1
364
Podcast -- New API documentation course at UW, with Bob Watson. In this podcast, I chat with Bob about an upcoming API documentation course he'll be teaching at the University of Washington. Listen here: idbwrtng.com/api-documentati… #api #ai #technicalwriting
1
3
13
734
New post: My 2024 technical writing trends and predictions idbwrtng.com/2024-tech-comm-… #techcomm #technicalwriting #ai #api
9
19
916
Etto, a new AI co-pilot for Heretto — Q&A with Casey Jordan (Sponsored post). Etto is a new AI copilot from Heretto designed to help content authors harness the power of structured content more easily. #techcomm #ai @helloheretto Read more: idbwrtng.com/heretto-etto-qu…
2
442
New post (and podcast): 30 ways I’m using AI in everyday writing life as a technical writer, blogger, and curious human. Read more: idbwrtng.com/all-the-ways-im… #ai #technicalwriting #documentation #apidocumentation #techcomm #writing #podcasts #apidocs
8
388
Podcast: Tech writing and Zen and the Art of Motorcycle Maintenance, with Dan Grabski Listen here: idbwrtng.com/zen-motorcycle-… #podcast #techcomm #apidocs #documentation #technicalwriting #quality #contentcreation

1
1
4
519
New post: Notes for Building the Cycling City: The Dutch Blueprint for Urban Vitality idbwrtng.com/building-the-cy… #cycling #urbandesign

Notes for Building the Cycling City: The Dutch Blueprint for Urban Vitality

In Building the Cycling City: The Dutch Blueprint for Urban Vitality, Melissa and Chris Bruntlett describe how the Dutch achieved so much cycling success, and how other cities might do the same. The...

idratherbewriting.com
5
9
2,673
New post: "My experience trying to write original, full-length human-sounding articles using Claude AI." By going paragraph-by-paragraph, you can direct the AI while seemingly maintaining your own voice and ideas. Read more: idbwrtng.com/writing-full-le… #writing #ai #creativity
1
4
460
New post: "Embracing professional redefinition" If AI transforms the tech writing field, as many think it will, we'll face a choice of either resisting change and skirting with obsolescence, or reinventing our professional identity. Read more idbwrtng.com/embracing-profe… #ai #techcomm

Embracing professional redefinition

If AI transforms the tech writing field, as many think it will, we’ll face a choice of either resisting change and skirting with obsolescence, or reinventing our professional identity. Reinventing...

idratherbewriting.com
2
4
842
New post: "Alphadoc: Build API documentation that tells your API's story" Alphadoc is a new tool for publishing API documentation. In this post, the cofounder tells the story behind Alphadoc and what makes it unique from other tools. idbwrtng.com/alphadoc @alphadoc_io #ai #api
1
8
386
New post: Claude versus ChatGPT -- and a few thoughts on using AI chatbots on an Alaskan cruise idbwrtng.com/claude-vs-chatg… #claude #chatgpt #ai #techcomm

Claude versus ChatGPT – and a few thoughts on using AI chatbots on an Alaskan cruise

In this post, I compare ChatGPT and Claude on an Alaskan cruise. Claude seems better at handling long content, and ChatGPT shorter content. Using both chatbots, I asked many questions to learn about...

idratherbewriting.com
1
314
New post: "Using AI for summaries." Providing summaries of content is one of the most useful and powerful capabilities of AI chatbots ... Read more: idbwrtng.com/use-ai-for-summ… #techcomm #technicalwriting #ai #documentation

1
2
410
New post: Using AI for glossary definitions Compiling and maintaining glossaries can be time consuming. Can AI tools help with glossaries? Just as AIs are good at creating summaries, providing definitions might be one of AI's strengths. idbwrtng.com/use-ai-glossari… #ai #techcomm
300
New post: "Using AI for comparison tasks with API responses" comparing two sets of information to identify inconsistencies in API responses can be tedious ... Read more: idbwrtng.com/aicomparison #techcomm #technicalwriting #ai #apidocumentation
3
3
581
New post: "Using AI For thematic analysis" - You can use AI for thematic analysis, which might involve identifying, analyzing, and reporting patterns (themes) within qualitative data. Read more: idbwrtng.com/api-thematic-an… #ai #documentation #analysis #technicalwriting #techcomm
2
362
New post: "Using AI tools to build, stage, and publish API reference docs" - At the core of API documentation work is the building, staging, and publishing of API reference content. Read more: idbwrtng.com/ai-scripts-buil… #ai #apidocs #techcomm #technicalwriting
1
7
500
Load more