Player FM - Internet Radio Done Right
39 subscribers
Checked 18d ago
Added nine years ago
Content provided by Tom Johnson. All podcast content including episodes, graphics, and podcast descriptions are uploaded and provided directly by Tom Johnson or their podcast platform partner. If you believe someone is using your copyrighted work without your permission, you can follow the process outlined here https://ppacc.player.fm/legal.
Player FM - Podcast App
Go offline with the Player FM app!
Go offline with the Player FM app!
Podcasts Worth a Listen
SPONSORED
V
Via Podcast


1 Close Encounters with UFO Hot Spots: Area 51, Roswell, and the Great ET Road Trip 39:50
39:50
Play Later
Play Later
Lists
Like
Liked39:50
The truth is out West! We’re hopping on the ET Highway and venturing to the most notorious alien hot spots, including Roswell’s infamous crash site, Area 51’s eerie perimeter, and a mysterious desert watchtower. Join us as journalist Laura Krantz, host of the podcast Wild Thing , beams up to share stories from the front lines of UFO reporting—from strange sightings and quirky festivals to a mailbox where people leave letters to extraterrestrials. Maybe you’ll even decide for yourself: Is Earth a tourist stop for spaceships? UFO hot spots you’ll encounter in this episode: - UFO Watchtower (near Great Sand Dunes National Park, Colorado) - Roswell, New Mexico - Area 51, Nevada - Extraterrestrial Highway (aka State Route 375), Nevada - Little A’Le’Inn, ET Highway, Nevada - E.T. Fresh Jerky, ET Highway, Nevada - Alien Research Center, ET Highway, Nevada - The Black Mailbox, ET Highway, Nevada Via Podcast is a production of AAA Mountain West Group .…
Podcast: Using file diffs for better release notes in reference docs
Manage episode 431198709 series 110257
Content provided by Tom Johnson. All podcast content including episodes, graphics, and podcast descriptions are uploaded and provided directly by Tom Johnson or their podcast platform partner. If you believe someone is using your copyrighted work without your permission, you can follow the process outlined here https://ppacc.player.fm/legal.
You can use AI prompts when creating release notes for APIs by leveraging file diffs from regenerated reference documentation. The file diffs from version control tools provide a reliable, precise information source about what's changed in the release.
…
continue reading
332 episodes
Manage episode 431198709 series 110257
Content provided by Tom Johnson. All podcast content including episodes, graphics, and podcast descriptions are uploaded and provided directly by Tom Johnson or their podcast platform partner. If you believe someone is using your copyrighted work without your permission, you can follow the process outlined here https://ppacc.player.fm/legal.
You can use AI prompts when creating release notes for APIs by leveraging file diffs from regenerated reference documentation. The file diffs from version control tools provide a reliable, precise information source about what's changed in the release.
…
continue reading
332 episodes
All episodes
×I
I'd Rather Be Writing Podcast Feed

1 Notes and discussion for Suleyman's The Coming Wave: AI, Power, and Our Future + AI Book Club recording and transcript 59:33
59:33
Play Later
Play Later
Lists
Like
Liked59:33
This post describes the key arguments and themes in The Coming Wave: AI, Power, and Our Future, by Mustafa Suleyman, for the AI Book Club: A Human in the Loop. This post not only breaks down the logic but also jumps off into some themes (beyond the book) that might be more tech-writer relevant, such as potential future job titles, areas of focus for tech writers to thrive now, questions for discussion, and more. It also contains the book club recording.…
I
I'd Rather Be Writing Podcast Feed

1 Notes and discussion for Jonathan Warner's More Than Words: How to Think About Writing in the Age of AI + AI Book Club recording 59:40
59:40
Play Later
Play Later
Lists
Like
Liked59:40
This post has notes and questions for discussion for More Than Words: How to Think About Writing in the Age of AI, published in February 2025 by Jonathan Warner. Warner's book, which explores what we lose when we outsource writing to AI, is the first book in the AI Book Club: A Human in the Loop.
I
I'd Rather Be Writing Podcast Feed

1 Rethinking traditional approaches to release notes -- recording of WTD Australia presentation 56:52
56:52
Play Later
Play Later
Lists
Like
Liked56:52
I gave a presentation to the Write the Docs Australia group on using AI to write release notes using file diffs, on Feb 16, 2025. Here's the recording, presentation description, and transcript.
I
I'd Rather Be Writing Podcast Feed

It's that time of year again when we take to analyzing trends. If you know me, you're probably gearing up for a load of AI-optimistic predictions because, as I've noted in previous posts like Unpacking the issues from AI, I'm an AI optimist. However, my AI optimism isn't based on hype or the current tech zeitgeist. Rather, I'm an AI optimist because my daily experiences using AI for technical documentation, especially API docs, throughout 2024 has shown it to be invaluable.…
I
I'd Rather Be Writing Podcast Feed

1 [Podcast] GenAI and Document360: Conversation with Saravana Kumar 49:36
49:36
Play Later
Play Later
Lists
Like
Liked49:36
This podcast explores GenAI in technical documentation scenarios, highlighting the AI features and capabilities provided in Document360. I talk with Saravana Kumar, CEO of Kovai.co, which makes Document360, about how AI is changing search functionality and reducing support costs in knowledge bases. We discuss practical applications of AI for technical writers, including automated tagging, SEO optimization, glossary creation, and more. Saravana shares about AI agent workflows, conversational search experiences, automating screenshot captures, and much more.…
I
I'd Rather Be Writing Podcast Feed

1 Podcast: Task decomposition and complex tree diagrams 18:38
18:38
Play Later
Play Later
Lists
Like
Liked18:38
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. Whether you're creating tree diagrams or not, it doesn't matter. This is just an example of how to break down complex information into smaller chunks and pass it into AI.…
I
I'd Rather Be Writing Podcast Feed

1 Podcast: Using long-token contexts to quality check an entire API doc set 21:58
21:58
Play Later
Play Later
Lists
Like
Liked21:58
One of the advantages of recent Gen AI updates is the massive token input context. When you can pass in an entire set of documentation as an input, you have a much stronger possibility for powerful prompts. In this tutorial, I share some quality-control prompts you can use that deal with entire doc sets as inputs, as well as explain some of the challenges in passing in an entire doc set.…
I
I'd Rather Be Writing Podcast Feed

1 Podcast: Using file diffs for better release notes in reference docs 17:31
17:31
Play Later
Play Later
Lists
Like
Liked17:31
You can use AI prompts when creating release notes for APIs by leveraging file diffs from regenerated reference documentation. The file diffs from version control tools provide a reliable, precise information source about what's changed in the release.
I
I'd Rather Be Writing Podcast Feed

1 Podcast: Populating documentation templates using AI 22:47
22:47
Play Later
Play Later
Lists
Like
Liked22:47
In this tutorial, you'll learn how to use AI to populate documentation templates with the source material you've gathered. For example, API overviews often follow a highly structured template. This technique can be a quick way to get an initial draft of documentation, which you can then edit and review with SMEs.…
I
I'd Rather Be Writing Podcast Feed

1 Podcast: Gathering source material for context input 18:02
18:02
Play Later
Play Later
Lists
Like
Liked18:02
One of the most successful strategies for using AI is to pass in an abundance of source material that can augument and inform the AI's responses. In this tutorial, I cover strategies for gathering this material, including what types of documents to look for, optimal ordering, pitfalls to look out for such as outdated or slanted information, and more.…
I
I'd Rather Be Writing Podcast Feed

1 Podcast: Creating high-fidelity, thematically organized notes from engineering meetings using AI 15:29
15:29
Play Later
Play Later
Lists
Like
Liked15:29
For AI tools to generate accurate information for documentation you're writing, you need to pass in source material. This usually means meeting with engineers and product managers to gather information about the product. In this tutorial, I share prompts for turning those meeting transcriptions into organized, readable meeting summaries. These cleaned up summaries can then function as input context for documentation-oriented prompts.…
I
I'd Rather Be Writing Podcast Feed

1 [Podcast] Uncovering and communicating the value of your tech comm teams' work, with Keren Brown 47:32
47:32
Play Later
Play Later
Lists
Like
Liked47:32
In this podcast episode, I talk with Keren Brown, VP of Marketing and Value at Zoomin Software, about strategies for technical writers to demonstrate their value within their organizations, especially in light of recent layoffs in the tech industry. We discuss aligning documentation work with high-priority initiatives, quantifying the impact of technical writing, and making this work visible to executive leaders. Keren also shares insights on the changing landscape of technical writing skills in the age of AI and the role of translation in modern documentation workflows. Overall, this podcast will show you how to establish yourself as a highly...…
I
I'd Rather Be Writing Podcast Feed

1 [Podcast] Breaking ground: New API documentation course at UW, with Bob Watson 53:05
53:05
Play Later
Play Later
Lists
Like
Liked53:05
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.…
I
I'd Rather Be Writing Podcast Feed

1 My 2024 technical writing trends and predictions 28:28
28:28
Play Later
Play Later
Lists
Like
Liked28:28
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,...…
I
I'd Rather Be Writing Podcast Feed

1 Podcast: Notes and themes from Zen and the Art of Motorcycle Maintenance by Robert Pirsig 1:03:29
1:03:29
Play Later
Play Later
Lists
Like
Liked1:03:29
These are some notes and thoughts from reading Robert Pirsig's classic philosophical novel, Zen and the Art of Motorcycle Maintenance, published in 1974. My reading here focuses more on the technical writing aspects and themes from the book. Some themes include Classic versus Romantic modes of thought, the concept of Quality, our relationship with technology, doing your own maintenance, caring about the work, peace of mind, systems thinking, multiple paths through a problem, troubleshooting, being in-the-scene versus removed, the road trip, effortless action, going with the flow, traveling along the backroads, and presence in the moment. I also include some...…
I
I'd Rather Be Writing Podcast Feed

1 Webinar recording: Experiments and use cases for AI from a tech writer’s perspective 1:02:34
1:02:34
Play Later
Play Later
Lists
Like
Liked1:02:34
I recently gave a webinar titled 'Experiments and use cases for AI from a tech writer’s perspective' on December 8, 2023. The webinar was sponsored by the STC Washington, DC - Baltimore Chapter. In this presentation, I shared some personal experiences in using AI for different writing-related use cases, explaining what I’ve found helpful. These use cases and takeaways were all experiential, based on my experiments with using AI both in the workplace for documentation-related scenarios and writing on my blog.…
I
I'd Rather Be Writing Podcast Feed

1 30+ ways I’m using AI in everyday writing life as a technical writer, blogger, and curious human 44:33
44:33
Play Later
Play Later
Lists
Like
Liked44:33
In this post, I provide over 30 real-life examples of how I'm using AI on a daily basis, not just for technical writing tasks but more broadly in life, including summarizing content, explaining concepts, answering questions, troubleshooting problems, and having engaging conversations for a variety of tasks and scenarios. In my view, AI use cases are ubiquitous, equivalent to the use cases for computers or the Internet in general.…
I
I'd Rather Be Writing Podcast Feed

1 Podcast: The evolution of podcasting, with Ed Marsh 57:24
57:24
Play Later
Play Later
Lists
Like
Liked57:24
In this podcast, I talk with Ed Marsh about podcasting. You may have listened to Ed Marsh's Content Content podcast previously. As an experienced podcaster, Ed has a lot of insights and thoughts about podcasting. We discuss what initially drew him to start podcasting, the equipment and logistics involved in podcasting, different formats that engage listeners (from co-hosts to single person podcasts, and more), incorporating AI tools, why podcasters often go on hiatus, the ongoing appeal of podcasting, and more.…
I
I'd Rather Be Writing Podcast Feed

1 Podcast: Tech writing and Zen and the Art of Motorcycle Maintenance, with Dan Grabski 42:12
42:12
Play Later
Play Later
Lists
Like
Liked42:12
In this episode, I chat with Dan Grabski, a senior content developer based in Portland, both about his recent WTD talk titled 'Zen and the Art of Manually Creating API Documentation' and Robert Pirsig's 'Zen and the Art of Motorcycle Maintenance.' Dan explains the importance of focusing not just on technical details of implementations but also on integrating the people side — on understanding the perspectives of different users and stakeholders involved. Dan provides examples from his engineering background to illustrate how intuition develops from experience, how to avoid spectator mode through hands-on exploration of APIs, on carving out time...…
I
I'd Rather Be Writing Podcast Feed

1 Doing research with AI tools -- avoiding the trap of fabricated URLs 14:56
14:56
Play Later
Play Later
Lists
Like
Liked14:56
In this short podcast, I explore using AI tools to do research, the potential for fake URLs, and how to deal with the fabrication. I started by using Claude to summarize a podcast and provide a list of salient points, including the potential counterargument. What I didn't expect was for Claude to fabricate a list of imagined research and then summarize the fictitious research to conclude that it lended support for the counterargument. I took Claude's list of research and pasted it into ChatGPT with Bing to browse the real-time web to validate the sources. Using Claude and ChatGPT in...…
I
I'd Rather Be Writing Podcast Feed

1 Notes for Building the Cycling City: The Dutch Blueprint for Urban Vitality 46:49
46:49
Play Later
Play Later
Lists
Like
Liked46:49
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 authors bring up a variety of techniques and approaches the Dutch have used, such as seamlessly integrating cycling with public transit, pursuing customized strategies based on each city's unique landscape and culture, taking an iterative approach to infrastructure, using tactical urbanism and prototyping, and more.…
I
I'd Rather Be Writing Podcast Feed

1 My experience trying to write original, full-length human-sounding articles using Claude AI 37:30
37:30
Play Later
Play Later
Lists
Like
Liked37:30
You can use AI tools like Claude to help you write full-length content. By going paragraph-by-paragraph, you can direct the AI while seemingly maintaining your own voice and ideas. However, despite my attempts to use AI with writing, I've found that it's harder to pull off than I thought. I can get close, but due to the way AI tools are trained, they inevitably steer into explanation more than argument. This can remove much of the interest from a personal essay.…
I
I'd Rather Be Writing Podcast Feed

1 Chatting about AI trends and tech comm with Fabrizio Ferri Benedetti 49:01
49:01
Play Later
Play Later
Lists
Like
Liked49:01
In this podcast, I chat with Fabrizio Ferri Benedetti, a tech writer in Barcelona who blogs at passo.uno and works for Splunk, about various AI news topics. We talk about the Forrester AI jobs impact forecast, the community element in documentation, the way the profession is changing with AI, content design roles with LLMs, how complex processes and interactions can't be automated, whether the word 'content' is problematic, and more.…
I
I'd Rather Be Writing Podcast Feed

1 [Podcast] AI and APIs: What works, what doesn't 1:00:58
1:00:58
Play Later
Play Later
Lists
Like
Liked1:00:58
In conversations about AI, a lot of tech writers are asking what kind of scenarios is AI good for? What works, what doesn’t? In which scenarios? You may have read my responses to these questions before in previous posts, but this time I recorded a podcast with slides. In the podcast, I try to pull together these ideas into more of a narrative shape and flow. This podcast focuses on clarifying those scenarios where AI excels and where it doesn’t, particularly for technical writers creating documentation. I also argue for the inevitability of AI integration through an argument referred to...…
I
I'd Rather Be Writing Podcast Feed

1 Presentation recording: Specialization myopia syndrome and the content journey 50:52
50:52
Play Later
Play Later
Lists
Like
Liked50:52
This is a recording of a presentation called Specialization myopia syndrome and the content journey, which I gave to a company's private tech comm event. With their permission, I'm posting it here. You can watch the recording via YouTube or listen the audio file as a podcast.
I
I'd Rather Be Writing Podcast Feed

1 Podcast: All about Redocly, with founder Adam Altman 36:16
36:16
Play Later
Play Later
Lists
Like
Liked36:16
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.…
I
I'd Rather Be Writing Podcast Feed

1 Podcast about Archbee -- a new documentation tool with a block-based editor, API publishing capability, content re-use, and more 29:09
29:09
Play Later
Play Later
Lists
Like
Liked29:09
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.…
I
I'd Rather Be Writing Podcast Feed

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.…
I
I'd Rather Be Writing Podcast Feed

1 [Podcast] Become a technical writer: conversation with Bobby Kennedy about the technical writing courses he offers
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.
I
I'd Rather Be Writing Podcast Feed

1 MEGAComm recording: How to increase awareness of tech comm inside corporate walls 52:55
52:55
Play Later
Play Later
Lists
Like
Liked52:55
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.
Welcome to Player FM!
Player FM is scanning the web for high-quality podcasts for you to enjoy right now. It's the best podcast app and works on Android, iPhone, and the web. Signup to sync subscriptions across devices.