Integrating AI with your content delivery platform and documentation: Zoomin Q&A with Keren Brown

In this post, I chat with Keren Brown at Zoomin Software about best practices for integrating AI with documentation. Keren emphasizes the importance of first making your content AI-ready, which means ensuring that it's accurate and up to date, before incorporating AI features. We discuss the reasons companies adopt AI, how to overcome implementation challenges, common mistakes, creativity vs. hallucination, consolidating content, user behaviors, security concerns, and measuring success.

Showcasing your API technical writer portfolio and projects — guest post by Peter Gustafson

How can you persuade potential employers about your API expertise? One of the strongest moves you can make is to share a link to your portfolio. The following is a guest post by Peter Gustafson, a technical writer who's had a lot of success with API documentation projects at many high-profile companies. I was chatting with Peter on Linkedin the other week about trends he's seeing in the field, and I asked him to write a guest post. In this post, he explains the importance of having an online portfolio that potential employers can easily access and browse.

Prompt engineering: Reverse engineering the recipe for excellent documentation

I added another article to my prompt engineering series on reverse engineering prompts. Reverse engineering a prompt can mean a few different things, but in this article, I'm referring to deriving the likely prompt based on a given output. For example, you pass in some finished content and ask the AI to write a prompt that would produce a similar output. Although reverse engineering prompts might not be all that different from simply coming up with a template for docs, I added this article here to emphasize that you can get AI to write prompts for you, and many times these prompts are good. They can be much more detailed and robust than manually written prompts.

Prompt engineering series: Populating documentation templates using AI

I added a new article to my prompt engineering series on populating documentation templates. In the article, I explain how to use AI to populate documentation templates with information that you've gathered. This technique can be a quick way to get an initial draft of documentation, which you can then edit and review with SMEs.

Prompt engineering: Task decomposition and complex tree diagrams

I added a new article about task decomposition to my prompt engineering series. This tutorial will help you understand task decomposition by guiding you through the process of creating a complex tree diagram that’s too sophisticated for an AI tool to create at once.

Prompt engineering: Creating high-fidelity, thematically organized notes from engineering meetings using AI

I added a new topic to my prompt engineering series on summarizing meeting notes. While using AI to summarize meeting notes might seem superficial, it’s not. When you tag people in meeting notes and broadcast the notes to larger lists of people, the notes can amplify your visibility and communication about the documentation projects you’re working on.

Upcoming conference: AI the API docs
Upcoming conference: AI the API docs

There's an upcoming conference called AI The Docs 2024: API Documentation and AI Best Practices, held April 3, 2024 online. The conference is put on by the same API the Docs group / Pronovix that holds other online conferences and events. I'll be one of the speakers. I'm planning to talk about prompt engineering.

Visualizing APIs with tree diagrams, partly generated with AI
Visualizing APIs with tree diagrams, partly generated with AI

I recently visualized both a cloud and Java API through some complex tree diagrams that showed the objects returned, with all the detail inherent in the parent/child relationships and structures. One of the primary principles of prompt engineering is to break complex tasks up into smaller ones. This principle has at least two purposes: (1) most AI chatbots can't process large amounts of text, and (2) you can more precisely direct the output from smaller inputs.

Walking and chatting with ChatGPT
Walking and chatting with ChatGPT

I've begun a new favorite activity: walking and talking with ChatGPT. It might sound crazy, but it's really engaging. As I walk around for exercise, I usually listen to non-fiction audiobooks or podcasts. Particularly with non-fiction audiobooks, I listen to learn something. For example, today I was listening to The Little Book of Common Sense Investing by John C. Bogle, founder of Vanguard. After about 20 minutes of listening to the book, my mind tends to gravitate toward questions I have. When I find myself losing interest in listening instead want to pursue specific questions, I pull out the ChatGPT app on my phone, tap the headphone button to initiate the audio conversation, and start asking questions related to topics surfaced in the book.

Moved AI pages into their own collection and space
Moved AI pages into their own collection and space

I recently moved the AI section from my API course into their own dedicated collection and space at /ai. I moved these AI pages into their space for one main reason: I anticipate writing a lot more about AI, and this content was outgrowing its chapter in the API documentation course.

Coffee Chat recording: Ask Me Anything about Managing API documentation projects
Coffee Chat recording: Ask Me Anything about Managing API documentation projects

I recently participated in a Coffee and Content chat titled 'Ask Me Anything: Managing API Documenation Projects', with Patrick Bosek and Scott Abel, sponsored by Heretto. This was an 'Ask me anything' style chat, though the audience could only participate through chat on Brighttalk's platform. The coffee chat took place on Thursday, Jan 11, 2024.

Evaluating my 2023 site analytics -- why did my traffic drop?
Evaluating my 2023 site analytics -- why did my traffic drop?

Once a year, usually at the beginning of January, I look at my site analytics with the latest numbers from Google Analytics and also reflect on trends, changing directions, and other metrics for the year. This weekend I updated my site's analytics for 2023. The metrics were kind of harsh for my site this year. Page views were down 35%, users down 37%. Page views per session were down 12%. My top 30 pages were almost all to pages in my API documentation course — almost none of which were new in 2023. Accounting for the shift could be the many changes to Google's search algorithms, the changes in Google Analytics itself, the layoffs and industry slowdowns in tech comm, the expanding influence of AI, stale content, and other reasons.

[Podcast] Breaking ground: New API documentation course at UW, with Bob Watson
[Podcast] Breaking ground: New API documentation course at UW, with Bob Watson

In this podcast, I chat with Bob Watson about an upcoming API documentation course he'll be teaching at the University of Washington. Bob has extensive experience working as an API technical writer at big tech companies like Microsoft, Amazon, and Google. The UW reached out to Bob to develop this new course offering. The 14-week evening course will cover fundamentals like understanding developer behaviors, working with various types of APIs, publishing workflows, as well as hands-on practice. A key component is having students create API documentation portfolios they can use to demonstrate their skills.

My 2024 technical writing trends and predictions
My 2024 technical writing trends and predictions

I've been mulling over whether to write a trends post this year. There's so much uncertainty, it's hard to feel confident about how the tech writing profession will play out. But little trends-related ideas keep surfacing in the back of my mind, so I decided to write out some of my thoughts. Before I jump into this, I want to say that I’m much more agnostic and unsure about directions this year. 2024 could be amazing, it could also be terrible. Or everything could be overblown and remain more or less the same. One thing is for sure: in predictions, AI dominates the scene and discussion.

Book review: Understanding Girls with ADHD: How They Feel and Why They Do What They Do
Book review: Understanding Girls with ADHD: How They Feel and Why They Do What They Do

Although my blog usually focuses on tech comm, I've started reviewing books covering wider topics. I recently read Understanding Girls with ADHD: How They Feel and Why They Do What They Do, by Kathleen G. Nadeau, Ellen B. Littman, and Patricia O. Quinn. Several of my family members have ADHD, and I wanted to understand ADHD more to better support them. This book is one of the best ADHD books I've read, probably because I have four daughters (ranging from 13 to 22) and the book focused entirely on ADHD in girls. The book describes challenges girls with ADHD face in elementary school, middle school, high school, and beyond.