I'd Rather Be Writing Podcast

[Podcast] GenAI and Document360: Conversation with Saravana Kumar Oct 06, 2024

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.

Podcast: Task decomposition and complex tree diagrams Jul 28, 2024

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.

Podcast: Using long-token contexts to quality check an entire API doc set Jul 28, 2024

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.

Podcast: Using file diffs for better release notes in reference docs Jul 28, 2024

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.

Podcast: Populating documentation templates using AI Jul 28, 2024

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.

Podcast: Gathering source material for context input Jul 28, 2024

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.

Podcast: Creating high-fidelity, thematically organized notes from engineering meetings using AI Jul 28, 2024

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.

[Podcast] Uncovering and communicating the value of your tech comm teams' work, with Keren Brown May 30, 2024

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...

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

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 Jan 01, 2024

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,...

Podcast: Notes and themes from Zen and the Art of Motorcycle Maintenance by Robert Pirsig Dec 15, 2023

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...

Webinar recording: Experiments and use cases for AI from a tech writer’s perspective Dec 13, 2023

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.

30+ ways I’m using AI in everyday writing life as a technical writer, blogger, and curious human Dec 04, 2023

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.

Podcast: The evolution of podcasting, with Ed Marsh Dec 03, 2023

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.

Podcast: Tech writing and Zen and the Art of Motorcycle Maintenance, with Dan Grabski Nov 18, 2023

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...

Doing research with AI tools -- avoiding the trap of fabricated URLs Nov 09, 2023

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...

Notes for Building the Cycling City: The Dutch Blueprint for Urban Vitality Nov 06, 2023

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.

My experience trying to write original, full-length human-sounding articles using Claude AI Oct 25, 2023

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.

Chatting about AI trends and tech comm with Fabrizio Ferri Benedetti Oct 20, 2023

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.

[Podcast] AI and APIs: What works, what doesn't Oct 14, 2023

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...

Presentation recording: Specialization myopia syndrome and the content journey Mar 07, 2023

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.

Podcast: All about Redocly, with founder Adam Altman Feb 26, 2023

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.

Podcast about Archbee -- a new documentation tool with a block-based editor, API publishing capability, content re-use, and more Oct 31, 2022

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.

Keynote presentation to STC India 2022 Mar 26, 2022

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.

[Podcast] Become a technical writer: conversation with Bobby Kennedy about the technical writing courses he offers Feb 21, 2022

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.

MEGAComm recording: How to increase awareness of tech comm inside corporate walls Feb 10, 2022

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.

Presentation recording -- 'Best practices in API docs: Product overviews and getting started tutorials' Oct 29, 2021

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.

tcworld China 2021 keynote: 'Tech comm and marketing: How to make your tech comm group more visible to those within your company' Sep 16, 2021

I recently gave a keynote presentation at tcworld China 2021 on the topic of tech comm and marketing. This post provides a recording of the presentation, slides, and detailed notes for the presentation.

Recording of 'Product overviews vs. getting started tutorials: striking a balance between read-first and try-first user behaviors' Aug 07, 2021

I recently gave a webinar to tekom Europe about product overviews and getting started tutorials. The recording and slides are below.

Videocast: Micro content and Flare -- Conversation with Kate Schneider Mar 21, 2021

In this videocast, I chat with Kate Schneider about micro content and Flare. Kate shares micro content examples from her current documentation and explains the strategies she considers when creating micro content. She shows specifically how to leverage analytics in determining micro content topics.

The story behind Document360 -- podcast with founder Saravana Kumar Nov 17, 2020

In a previous post, I explored how Document360, a new cloud-based documentation platform, handles API documentation scenarios. This time, I decided to record a podcast with Saravana Kumar, founder of Document360, to get the behind-the-scenes story about how Document360 came about, what's driving their fast pace of development, and their roadmap for the future.

Playing a product design role as a content designer -- podcast with Jonathon Colman Aug 24, 2020

In this podcast, I chat with Jonathon Colman about an innovative work model they implemented at Intercom with content designers. In their experimental model, content designers were allocated to one project only, and they expanded their roles to include not only content design but product design as well. These content/product designers engaged on a deeper level to help products succeed.

A tip for doc reviews -- bring a list of questions Jul 24, 2020

Although doc reviews are a central part of the tech writing process, it's often a challenge to get teams to review docs. One tip is to bring a list of questions to the doc review. This provides more structure and focus to the review meeting.

Developer portal strategies for complex landscapes -- conversation with Kristof van Tomme Jun 24, 2020

Recently I chatted with Kristof van Tomme, CEO and co-founder of Pronovix, about a topic that's become increasingly relevant in the past several months: how to deal with complex, rapidly evolving landscapes. Specifically, we focus on developer portal strategies that involve finding a balance between constraints and flexibility. Too many constraints reduces your ability to adapt to uncertain changes that might require innovative, unknown solutions. Too much flexibility might not lead to any coherent, overarching story about how to use your APIs in an integrated way toward a business goal.

API the Docs recording: How Trends in API Documentation Differ from other Tech Comm Trends Jun 04, 2020

I recently presented a session at the API the Docs virtual series on Wednesday, May 27, 2020, as part of the 5th edition. My session covered dev doc trends, and another session covered API design. A recording of my presentation is available below.

WTD Australia event recording -- 'Remote discussion: Techcomm in the times of pandemic' May 31, 2020

I recently co-presented in a WTD Australia event titled Techcomm in the times of pandemic on May 28, 2020. The other presenter was professor Kirk St. Amant. A recording is available below.

Are technical writers increasingly playing non-technical roles? Some thoughts on the evolution of technical writing roles Mar 30, 2020

How is the role of the technical writer evolving? It seems we're moving away from writing and more towards other roles, such as reviewer/convener, user champion, editor, publisher, and promoter. However, it's difficult to gauge change, especially across different job categories. In some scenarios, writing might never have been why we were hired.

Podcast: Users as producers of knowledge -- conversation with Nupoor Ranade about how tech writer roles are changing Mar 29, 2020

How can users shape and influence the documentation you're producing? In this podcast, I chat with Nupoor Ranade, PhD candidate at North Carolina State University, about how the roles of technical writers are changing. Instead of writers authoring content for passive users, users are actively directing and shaping the knowledge that writers produce. In this podcast, we look at ways docs-as-code workflows are facilitating that shift in roles. This podcast is more of a conversation, where I first ask Nupoor a series of questions, and then she asks me questions. There's also a transcript of the podcast.

Webinar recording: How Trends in API Documentation Differ from other Tech Comm Trends Mar 12, 2020

I recently gave a webinar on trends in developer docs to the STC Washington DC chapter on March 12, 2020. In this presentation, I presented the results and analysis of my Trends in Developer Documentation 2020 survey. A recording and audio file is available below.

Introduction to API documentation - Recording from Los Angeles API documentation workshop Mar 11, 2020

In January I gave an API documentation workshop in Los Angeles, and I recorded the first section of the workshop. This section provides an introduction to APIs, including an overview of APIs, the API doc market, info about API popularity, how to submit requests through Postman, and other trends. The recording is available as both a video/audio or standalone audio.

Podcast: How Paligo is filling a niche in the CCMS market for complex documentation, with Anders Svensson Mar 09, 2020

I recently chatted with Anders Svensson about how Paligo, a cloud-based CCMS, is filling a niche in the CCMS market for complex documentation needs. Complex documentation refers to documentation with multiple product variants, versions, languages, audiences, and more. In these scenarios, content re-use and scalability become more challenging. Paligo is filling a need for documentation teams that have grown beyond their help authoring tools and need the more robust support that a component content management system (CCMS) offers but without the price tag and implementation timeline.

Podcast with Andrew Davis: Hiring API doc writers -- an inside look at fixing broken processes Feb 23, 2020

I recently chatted with Andrew Davis, a recruiter for API documentation positions in the San Francisco Bay area, about why it's so difficult to hire technical writers for developer documentation roles. Andrew has more experience and knowledge with developer doc jobs, companies, and recruiting processes than nearly anyone else in the tech comm industry. He actually helped me find my first dev doc job when I transitioned to California years ago. Andrew's company is called Synergistech Communications. In this interview, Andrew provides an inside look at fixing broken processes around hiring.

From API docs to developer portals Feb 09, 2020

One comment I often hear from API workshop participants and other readers is that they want a more advanced API course. I've been thinking about what that more advanced course would involve, in addition to what might be involved in leveling up at my work, and I've come to a realization that I need to transition more from API documentation to developer portal strategies. Developer portal strategies includes API documentation but also encompasses broader concerns as well, not too different from content strategy.

Podcast: API Design and Usability with Arnaud Lauret (API Handyman) Dec 07, 2019

Arnaud Lauret, also known as the API Handyman, recently published a book called The Design of Web APIs. In this podcast, I chat with Arnaud about his book, specifically exploring best practices for designing web APIs and focusing on the roles technical writers can play.

Podcast: Dealing with Project Overload -- Strategies to Manage Overflowing Documentation Tasks Oct 02, 2019

In this podcast, I talk about how to deal with project overload, specifically covering strategies to manage tasks. Scrum is one framework for dealing with project work by allowing you to limit the work you have before you in a more systematic way. I also explain the importance of focusing on a project to build up flow and momentum, without always context switching.

Podcast: 10 myths about API documentation Sep 29, 2019

In this podcast, I debunk 10 myths about API documentation. For example, some myths are that only engineers can write API docs, or that you have to write API docs by deciphering an engineer's source code. In this podcast, I go through these myths one by one with discussion and analysis.

Recording of Tech Comm Trends Presentation (STC Puget Sound chapter) Jun 08, 2019

I recently gave a presentation on technical communication trends to the STC Puget Sound Chapter in Seattle, Washington, on May 21, 2019. This is one of the better presentations on trends I've given and culminates a lot of research and other iterations on this topic during the past year. You can view a recording of the presentation, check out the slides, grab the audio file, and see other details here.

Crash course in API documentation -- a one-hour video May 16, 2019

If you want a condensed, one-hour version of what I cover in my API documentation workshop, check out this crash-course video.

Corporate exodus narratives: A close look at the tension between the corporation and academia Mar 01, 2019

Corporations often expect tech comm academics to fashion their curriculums to suit corporate needs; in contrast, academic departments want to give students a safe space free of corporate agendas for critical inquiry. Tech comm academics are often caught between these two groups and must satisfy both.

Recording and slides for my trends presentation at the Symposium for Communicating Complex Information (SCCI) Feb 24, 2019

This week I traveled to Louisiana to attend the Symposium for Communicating Complex Information and presented on tech comm trends. You can listen to the recording, view my slides, and read my latest thoughts on trends here.

How to become a 10X technical writer in the workplace Feb 07, 2019

How do you become a 10X technical writer in the workplace (10X means 10 times more efficient and productive than others)? In this post, I raise the question and then offer a few tips I try to follow: (1) Record your meetings with engineers, (2) Respond quickly to emails and messages, (3) Iterate on content with ever-expanding layers of reviewers, (4) Put some work back on those who request it, and (5) Learn to say no so you can focus on fewer projects with deeper engagement.

How to motivate users to provide feedback: Show that you're listening to their input Feb 01, 2019

To encourage users to leave more feedback, add a contact email field on your feedback submission form. When you receive feedback, provide a quick response that shows you're listening and taking action on their input.

Site analytics from Jan 1 to Dec 31, 2018 -- are more engineers writing docs now? Jan 14, 2019

Every year, when I re-examine my site analytics, I take the time to reflect on trends I’m seeing with traffic to my own site. Not necessarily industry trends, just trends about which topics are popular on my site. Based on these trends, I assess and re-evaluate some of my directions. This year, I found that the increase in traffic on my API documentation site (which accounts for 59% of my overall site traffic) suggests that more engineers are writing docs. This confirms my earlier predictions at the beginning of 2018 that specialization will drive more engineers to write API documentation,...

Recording for Menlo Park API documentation workshop now available -- and some thoughts on using cardioid versus omnidirectional microphones for recording Dec 04, 2018

The recording for the full-day API workshop that I recently gave in Menlo Park, California, is now available. This recording provides more than 5 hours of instruction about writing API docs -- for free. I also share some thoughts on cardioid versus omnidirectional microphones, and which is better in a workshop setting. The audio narration of this post switches around the microphones so you can hear the difference.

New post in Simplifying Complexity series -- Principle 11: Be both a generalist and specialist at the same time Nov 30, 2018

In my Simplifying Complexity series, I added a new post called, Principle 11: Be both a generalist and specialist at the same time. I also recorded this essay as a narrated podcast.

How to avoid being a secretary for engineers Nov 19, 2018

If we just see our task as documenting solutions that engineers have solved, it removes the creativity and critical thinking dimension from tech comm. The creative dimension in tech comm comes into play as we identify and solve tech comm challenges, such as devising ways to simplify complexity or otherwise improve the user experience.

Upcoming full-day API documentation workshop in Menlo Park Oct 31, 2018

I'm giving a full-day API documentation workshop on Nov 8, 2018, in Menlo Park, California, in coordination with Scott Abel (aka, The Content Wrangler). There are still a few open spots left in the workshop.

Preferring technical acuity over specialized knowledge Oct 24, 2018

In the debate between being a specialist or generalist, there's also a third option: developing technical acuity. A person with a high degree of technical acuity has the technical mindset needed to understand and solve problems across a variety of technical domains. Given the ever growing number of technologies, developing technical acuity can be more advantageous, especially in technical writing contexts since technical writers work with a lot of different technologies.

If writing is no longer a marketable skill, what is? Aug 09, 2018

When we try to sell our tech comm skills, promoting our writing skills doesn't seem to impress people anymore, as writing is considered more of a presumed skill everyone has. To give a sense of value, we need to hyphenate our job titles, becoming more of a hybrid professional.

My conflicted thoughts about the decentralized web (while taking the Census of Technical Communicators survey) Aug 06, 2018

Seeing my name in the Census of Technical Communicators survey as a possible source for professional development made me think about the impact of blogs as a learning resource. Advertising encourages bloggers to create rapid-fire, lightweight content in order to increase page views and other attention on the advertised product or service. The proliferation of blog content turns the wheels of social media, creating micro-bursts of attention for companies. The negative impact, however, is that more traditional forms of learning, such as scholarly journal articles and books, take a hit. The web's architecture and monetization model around content is optimized...

Articulating stories that influence product adoption (new article in Simplifying Complexity series) Jul 31, 2018

I added a new article in my ongoing series about simplifying complexity. The article is called Articulating the invisible stories that influence product adoption or rejection and explores why adoption of our products among users doesn't often live up to our expectations. I argue that we need to articulate the story we're telling about the product as well as the story users tell, and identify whether the two are in alignment. Note that you can both read and listen to this article, since I created an audio recording for it.

The relationship between academics and practitioners -- Podcast with Kirk St. Amant Jul 11, 2018

In this podcast, I chat with Professor Kirk St. Amant about the relationship between practitioners and academics. Kirk recently co-authored an article about research as a unifying focus to bring academics and practitioners together. Using this article as the basis for discussion, we dive into origins of the divide, why both practitioners and academics of the same field need each other, potential solutions, and more.

Reducing the complexity of technical language (new article in Simplifying Complexity series) Jul 11, 2018

I added a new article in my ongoing series about simplifying complexity. The article is called Reducing the complexity of technical language and explores reasons why the language in technical documentation tends become so full of jargon and other unfamiliar terms, and a few solutions for simplifying the language. I emphasize the need to read the competitor's documentation and other articles in the industry to get a sense of the right terms and contexts that users likely expect. I also decided to read the article for those who prefer podcasts.

Evaluating the user experience of documentation -- Podcast with Bob Watson Jun 18, 2018

This week I chatted with Bob Watson, an assistant professor of tech comm at Mercer University, about how to evaluate the user experience of documentation. The idea of doing a podcast came up during a comment thread on a previous post about reconstructing the absent user. We had a long exchange in the comment threads and thought it would be good to have a podcast about the topic.

Recording of API documentation workshop in Denver Mar 12, 2018

I recently gave a half-day API workshop in Denver on March 10, 2018. Topics in the workshop included how to document reference API content (endpoints, parameters, requests, etc.), what non-reference topics (for example, status and error codes, rate limiting, getting started, sample apps) are common, how to create an OpenAPI specification document and Swagger UI output, and more. You can view a recording of the workshop, browse the slides, and listen to the audio here. Because of the length, the content is divided into three parts.

Recording of STC San Francisco presentation: Beyond mere endpoint reference — the overlooked content in API documentation Mar 08, 2018

I recently gave a presentation to the STC San Francisco chapter called "Beyond mere endpoint reference — the overlooked content in API documentation" on February 21, 2018. You can browse the slides and listen to the audio recording here.

Recording of OpenAPI and Swagger presentation (for STC and WTD San Diego) Feb 14, 2018

I recently gave a presentation to the STC San Diego chapter and WTD San Diego group called "Swagger UI and the OpenAPI specification" (February 13, 2018). You can view a recording of the presentation, browse the slides, and listen to the audio here.

Recording of WTD South Bay presentation: Publishing tools for API documentation Jan 19, 2018

I recently gave a presentation called "Publishing tools for API documentation" to the Write the Docs South Bay meetup group on January 18, 2018. You can view a recording of the presentation, browse the slides, and listen to the audio here.

How to become a voracious reader Dec 01, 2017

Voracious reading begins with voracious thinking. Asking questions gives us a purpose and drive for reading.

How do you communicate user progress in a course without a Learning Management System (LMS)? Nov 28, 2017

When you don't have a system that logs users in and tracks their progress, it can be a challenge to show their progress in a course. However, rather than showing progress through completed pages, quizzes, or other interactive exercises, progress can also be measured through larger user goals that extend beyond the course. In the case of my API documentation course, the user's goal is to break into the field of API documentation, not so much to finish a course. Breaking into API documentation requires users to build a compelling portfolio, which is how I'm choosing to measure the user's...

Intro to API Documentation -- recording of presentation to STC Silicon Valley chapter on 11/20/2017 Nov 19, 2017

I recently gave a presentation titled "Introduction to API Documentation" to the STC Silicon Valley chapter in Santa Clara, California. The video recording and audio are available here.

SwaggerHub: A collaborative platform for working on OpenAPI/Swagger specification files, and more Oct 05, 2017

When documenting REST APIs, the OpenAPI specification (formerly called Swagger) is pretty much the default standard. Yet learning the OpenAPI spec is not a trivial undertaking and requires significant ramp-up. SwaggerHub is a tool can reduce the complexity in creating your OpenAPI spec file because it enables collaboration between both developers and technical writers. This collaboration not only helps compensate for gaps in understanding with the spec, SwaggerHub also offers many other features (such as versioning, content re-use, inline commenting, and more) to make the authoring and publishing experience easier.

Has plain language deepened or ruined our delight in language? Sep 20, 2017

Although technical writers champion plain language, embracing plain language for many years can cripple your ability to use more eloquent language, like that of a literary author or essayist. There isn't much room for literary play or playful tones in technical documentation. Following the rules of simple language has distorted my ability to read anything that blatantly violates those rules without questioning the author's word choice and sentence construction. Sometimes I feel that simple language has removed my ability to delight more in language and to express myself in more articulate, interesting ways.

Discoveries and realizations while walking down the Docs-as-Code path Aug 23, 2017

This past week I had some good discussions with developers about the right directions in our doc-as-code project at work. I say good discussions, but actually they were challenging. The outcome led me to realize more details about embracing docs as code. The more you treat docs as code, the more you may have to set aside some common tech writer models of handling content and instead embrace the software code workflows entirely. Some of these principles include storing only source code in repositories, building from a build management system, and reducing build pipelines to work with 1 or 2...

Why Stack Overflow's Documentation effort failed -- a few thoughts from a technical writer's perspective Aug 05, 2017

Stack Overflow, mostly known as a forum for answering niche software questions, recently tried to launch a Documentation component to their site. The goal of Documentation was to 'do for Documentation what we did for Q&A'. In other words, provide substantial, valuable information that could be the go-to source for tech docs instead of just one-off answers around niche topics. However, the effort failed and now Stack Overflow is sunsetting their Documentation.

Tech docs and Agile: Alternatives to integrating into engineering Scrums (Part 2) Aug 04, 2017

This is part two in a series on Agile and tech docs. In the previous post, I outlined challenges in integrating into engineering Scrum teams. Some alternatives to Scrum include Kanban, Extreme programming, Waterfall, and various productivity methodologies. The most compelling solution, to me, seems to be to form your own documentation-focused Scrum. This allows you to keep with the same project management approach and language in the company, while also allowing you to avoid the pitfalls previously described with integrating into an engineering Scrum. Even so, there's not an extremely compelling reason for docs to adopt Scrum, so its...

Tech docs and Agile: Problems with integrating tech writers into engineering Scrums (Part 1) Aug 04, 2017

Although it seems like documentation should be treated like other features worked on by a Scrum team, frequently it is not. When tech writers try to integrate into engineering Scrum teams, they usually run into a host of challenges. These challenges stem mainly from floating across multiple projects. Often doc tasks aren't assigned points or grouped in with other tasks in a real sprint, nor are tech writers co-located with project teams. This is a two-part post. In this first part, I outline problems for tech writers integrating into Scrum teams. In part 2, I explore solutions.

Why simple language isn't so simple: the struggle to create plain language in documentation Jul 27, 2017

Although you can adjust your content's style to be simpler and more readable, technical documentation introduces many new terms and concepts for readers to learn. Many readers who don't already understand the discourse community may find this language impenetrable. Glossaries and inline tooltips can potentially help novice users, but there's no easy solution for simplifying your language for both novice and expert users.

When the pain of ignorance exceeds the pain of learning Jul 23, 2017

Users turn to documentation when the pain of their ignorance exceeds the pain of learning. Unfortunately, this is the worst state of mind to try to learn anything in. To address this impatient state of mind, we need to write documentation in simpler, easier to digest ways. Task-based documentation gets us part way there. But the varying starting points, unique pathway needs, and messy branching complicate the promised simple linear nature of steps. Overall, we need to increase the simplicity factor in our docs much more than we generally do.

Transparency in documentation: dealing with limits about what you can and cannot say Jul 13, 2017

Although traditionally as a technical writer you don't run into too many ethical scenarios for docs, sometimes you have situations where your ability to be transparent about a system's limitations gets curtailed by marketing or product management. It can be frustrating to have your documentation filtered like this, but you can take comfort knowing that, given the decentralized nature of information on the web, where any user can post information in forums, blogs, and other sites, the information filtered out of your docs will eventually be published online (it just might not be published by you).

Recording of my WTD Portland 2017 presentation on Building navigation for your doc site -- 5 best practices Jun 08, 2017

Here's the recording of the presentation I gave at the Write the Docs 2017 Portland conference. The presentation explores best practices for doc navigation, including principles such as hierarchy, modularity, progressive disclosure, entry point, and wayfinding. The presentation is about 20 minutes long, and you can either watch a video or listen to audio. Other WTD presentation recordings are also available.

Recording of User-Centered Design Principles for Organizing Documentation Feb 18, 2017

I recently presented to the STC Twin Cities chapter on User-centered Design Principles for Organizing Documentation. When organizing your documentation, such as arranging navigation titles, workflows, or other wayfinding features, you can apply universal design principles to make your content more user centered. Some of these principles include Modularity, Hierarchy, Five hat racks, and Progressive disclosure. These design principles, based on solid user research from design gurus, will help users better find and navigate your help content. You can view the recording and audio from the event here.

Recording: Modern Technical Writing, by Andrew Etter (STC Silicon Valley chapter) Jan 24, 2017

Andrew Etter presented about his book, Modern Technical Writing, to the STC Silicon Valley chapter on January 24, 2017 in Santa Clara, California. In the presentation, Andrew talks about the strategies he implemented at Palantir to change to a new way of doing docs. This new way includes having a smaller team, using text editors, writing in plain text, processing pull requests instead of bugs, and more. He dives into lightweight markup syntax, static site generators, version control tools, and more, as well as challenges he has faced.

Recording: Writing tech docs like a hacker with Jekyll Jan 18, 2017

I recently gave a presentation titled Writing tech docs like a hacker with Jekyll to the to the Southern Ontario STC chapter (on Jan 18, 2017). In the presentation, I introduce reasons why we started using Jekyll, how static site generators differ from content management systems, how to get started with Jekyll, and challenges involved in using Jekyll for technical documentation sites.

Recording of Open Authoring -- Collaboration Across Disciplines presentation, by Ralph Squillace Nov 15, 2016

Ralph Squillace, a senior content engineer for the Microsoft Azure Infrastructure team based in San Francisco, California, recently gave a presentation to the STC Silicon Valley chapter (on November 14, 2016) on Open Authoring -- Collaboration Across Disciplines. In the presentation, Ralph talks about Microsoft's approach to scaling their authoring and publishing efforts across the company by embracing Markdown, Github, open source tools, and other processes that allowed everyone in the company to write and contribute to Azure's documentation.

Saving Your Sanity Through Better Client Relations -- with Alisa Bonsignore Oct 18, 2016

In this presentation, Alisa Bonsignore, a technical communication consultant based in the San Francisco Bay area, talks about how she developed confidence and experience in consulting with clients about writing projects. In the beginning, Alisa started out by apologizing for projects in which she worked excessive numbers of hours for little pay, often trying to meet last-minute requests that required late nights and zapped her work-family balance. But project by project, she started to understand how to interact with clients in a more professional, self-respecting way. Ultimately this helped save her sanity and build a stable income through a reputable...

How can technical writers thrive in agile environments? Event recording and details Sep 20, 2016

Last Monday we had a record turnout at our STC Silicon Valley chapter (with about 40 attendees). The topic was a panel discussion on how to thrive in agile environments as a technical writer. With 5 panelists all from different companies, the perspectives and practices they shared varied a bit, which showed the adaptations different writers and companies have made with agile to make the process work for them. This post contains a full description and recording of the event.

Recording of Let's Tell a Story -- Scenario-Based Documentation, by Matt Ness (STC Silicon Valley Presentation) Sep 02, 2016

Matt Ness, a technical writer at Splunk and a co-organizer for WTD San Francisco, recently gave a presentation to the STC Silicon Valley chapter called Let's Tell a Story: Scenario-Based Documentation. In this presentation, Matt talks about ways to integrate storytelling techniques into documentation, drawing upon his experience as a Dungeons and Dragons player and his player experience from other video game or fantasy worlds. To help users on their journeys and quests, you need a narrative to guide them and a manual to help them overcome obstacles. Video, slides, and audio from the presentation are included in this post....

Balancing the never-ending list of documentation to write with your natural interests and passions Sep 02, 2016

Sometimes I think that I've covered every possible topic on this blog that is possible to write about, and my muse becomes silent for a while. But then I remember the purpose of the blog -- to be a web-based log, or journal -- and I realize that the only reason I wouldn't have anything to write about is if I stopped having experiences, stopped reflecting on those experiences, and ultimately became a zombie. That zombie state is the death of any career.

Presentation recording: Hunting for API developer documentation jobs in the San Francisco Bay area, by Andrew Davis Aug 15, 2016

Andrew Davis recently gave a presentation on finding developer documentation jobs (mostly for API documentation) in the San Francisco Bay area. The title of the presentation is Hunting for Dev Doc Work around the Bay. You can listen to the presentation recording, check out the slides, or just download the audio.

The complexities of translation and the need for dynamic variables in the build process Aug 15, 2016

Translation is a complex undertaking that usually requires you to take advantage of dynamic variables and other parameters in your source format in order to generate out different languages. Although most people think of static site generators as containing static content only, it's actually only static output. During the build process, you can take advantage of these more dynamic characteristics to handle rules for outputting to different languages. In this post, I explain some of the details you have to account for (includes, links, images, re-used content, etc.) when managing a translation project using a static site generator such as...

Will the docs-as-code approach scale? Responding to comments on my Review of Modern Technical Writing Aug 01, 2016

My previous post reviewing Andrew Etter's ebook on Modern Technical Writing got an enormous response. Some readers said the docs-as-code approach works only for small shops and doesn't scale to large projects. They said content re-use and translation also become problematic. However, perhaps the real differentiator shouldn't be product size as much as product category. The docs-as-code approach (which is what I'm calling it) works particularly well for developer documentation, such as API documentation, which usually doesn't contain the same challenges that component content management systems (or CCMSs) were meant to solve.

The Story of Paligo: A new browser-based CCMS with all the features you'd ever want Aug 01, 2016

Up until two years ago, Anders Svensson and his colleagues, based in Sweden, provided DITA and XML consulting. They eventually created their own XML-based component content management system (CCMS) called Paligo, which includes a full set of documentation features to handle single-sourcing, translation, and other documentation needs. Paligo solves the challenges that Svensson's customers had been facing for years with other CCMS systems.

Review of Andrew Etter's ebook on Modern Technical Writing Jul 26, 2016

In Modern Technical Writing: An Introduction to Software Documentation, which is an e-book you can read on your Kindle, Andrew Etter argues for a model of technical writing that involves lightweight markup languages (like AsciiDoc and Markdown), static site generators (such as Sphinx), distributed version control systems (like Git or Bitbucket), constantly iterating/updating doc content on your website based on analytics, and more. Etter's book resonated with me because it articulates so many of the principles I've felt about how documentation should be.

Applying Tim Ferriss' 4-hour work week rules to tech comm projects Jul 20, 2016

Principles in Tim Ferriss' book The 4-Hour Work Week can be applied to tech comm projects. By focusing on the 20% of tasks that result in 80% of the results, limiting your focus to two mission critical tasks a day, empowering those around you to make decisions, and avoiding distractions from trivial tasks, meetings, and email, you can be much more productive in your work. More than crossing off a list of tasks, this approach will likely make your efforts matter.

Thoughts on Transforming Documentation Processes presentation at WTD: Evaluating the trend to treat documentation as code Jul 15, 2016

At the last Write the Docs conference, Riona Macnamara, a tech writer working on internal developer documentation at Google, moderated a panel about transforming your documentation process. The panel consisted of four writers from various companies -- Balsamiq, Rackspace, Microsoft, and Twitter. The panelists talked about how they increased collaboration and openness in their company's doc culture by transforming their authoring and publishing processes. Most of these transformations involved adopting a 'docs as code' type approach, which seems to be a growing trend.

Context switching and efficiency -- Kanban to the rescue? Jul 13, 2016

In Become More Productive and Motivated, Mattias Sander provides a well-written overview of Lean, which is a strategy for eliminating waste and focusing more on customer value. What interests me most with Sander's discussion about Lean is context-switching and the subsequent strategy of Kanban, which uses cards to regulate flow. While these principles were developed in the context of Japanese car manufacturers (namely Toyota), they apply equally to the technical writer's world.

Why Programming Sucks and the fallacy of documentation in the context of code chaos Jul 12, 2016

Yesterday on Write the Docs, someone shared an article titled Programming Sucks, by Peter Welch. More than just a developer monologue, this article seems to hit on universal truths about programming, so much so that the article has been translated into 10 languages and even has a professionally-read audio version on iTunes (which I bought for $2).

Thoughts on Documentation Avoidance for Programmers Jul 09, 2016

This past week on the Write the Docs forum, there was a bit of discussion around a recent presentation titled Documentation Avoidance for Programmers. In the presentation, Peter Hilton lays out a series of tips on how programmers might get out of writing documentation.

Presentation recording: Move Fast And ... Document Things? Lessons learned in building documentation culture at a startup, by Ruthie Bendor May 22, 2016

During the May WTD meetup, Ruthie Bendor, a web engineer, gave a presentation titled Move Fast And ... Document Things? Lessons learned in building documentation culture at a startup. This post contains the audio and video recording of her presentation.

Recording of 'Two great teams that work great together: Bridging the gap between documentation and support,' by Neal Kaplan at Write the Docs May 22, 2016

We recently hosted a Write the Docs meetup in Redwood City with a couple of excellent presenters. Below is the recording of Neal Kaplan's presentation. I also explain a bit about my new lapel mic and recording process.

Recording of WTD presentation on Video Documentation, by Alicia Avrach Apr 24, 2016

Alicia Avrach, a content strategist at ThoughtSpot, gave a presentation about video documentation at a recent Write the Docs San Francisco meetup. In this presentation, Alicia covers all the aspects of video production, from scripting to recording, post-processing, publishing, and more.

Recording of STC-SV presentation on the Shape of a Modern Technical Communication Organization, by Sanborn Hodgkins Apr 24, 2016

Sanborn Hodgkins gave a presentation to the STC Silicon Valley chapter called Shape of a Modern Technical Communication Organization on April 18. In the presentation, she highlights the variety of roles -- editor, videographer, information architect, content strategist, manager, writer, tools developer, and others -- that tech comm organizations need to thrive.

Spec-driven Development with RAML -- presentation by Michael Stowe to STC Silicon Valley chapter Jan 09, 2016

In October 2015 Michael Stowe presented to the STC Silicon Valley chapter about spec-driven development, with a demo of RAML, which is an API specification similar to Swagger. Pretty much everyone who attended his presentation was impressed at how cool RAML is in making API documentation interactive. You can view Michael's slides and listen to the spec-driven development presentation recording here.

Recording of Creating Documentation for Startups: Panel Discussion -- Write the Docs San Francisco Dec 22, 2015

The following is a recording of a panel discussion at a Write the Docs San Francisco meetup held Dec 17, 2015. The topic is on creating documentation for startups.

Recording of Version Control, Writers, and Worfklows by Richard Mateosian Dec 17, 2015

You can watch the recording of Richard Mateosian's November 2015 presentation to the STC Silicon Valley about version control, writers, and workflows.

Podcast: Spec-driven Development of REST APIs, with a focus on RAML -- interview with Michael Stowe Oct 12, 2015

Spec-driven development is an approach to developing REST APIs by first describing and prototyping the API through a specification file (such as RAML or Swagger), and then coding the API. The spec not only serves as a contract for the API's development, it can also generate interaction documentation, unit tests, client SDKs, and provide other benefits.

Udemy podcast (with me) and infographic on technical writing Oct 06, 2015

Recently I was interviewed by Alex Bankoff from Udemy for a podcast on the field of technical writing. The Udemy team also created an infographic about the topics covered in the podcast.

Podcast: The divide between academics and practitioners -- Interview with Lisa Meloncon Aug 10, 2015

In this podcast, I talk with Lisa Meloncon, an associate professor at the University of Cincinnatti, about the academic-practitioner divide.

Podcast: How do design, length, and relevance affect how people use API reference docs -- interview with Bob Watson Jul 30, 2015

Bob Watson recently finished a PhD with research that examined how the design and content of API reference docs affects the user's performance. In this podcast, I talk with Bob about his findings and his other research interests, primarily around goal testing to measure documentation's effectiveness.

The key to writing good documentation: Testing your instructions Jul 07, 2015

Writing good documentation requires you to set up a test environment and test all of your instructions -- testing the instructions yourself and against a user. Testing instructions can be time consuming and tricky, especially with developer documentation. It's hard to see past personal blind spots and assumptions. But testing instructions gives you access to insight that makes your documentation much more accurate and useful.

Introduction to technical writing -- slides and audio recording May 16, 2015

API Documentation presentation to East Bay STC chapter -- slides and recording May 16, 2015

The other week I gave a introductory presentation on API documentation to the East Bay STC chapter in Silicon Valley. Here are the slides and recording.

Recording and slides from "Jekyll vs. DITA: Bridging the Gap Between Tech Comm and the Web" presentation May 14, 2015

Recording of API documentation workshop (REST and Javadoc) at tcworld India 2015 Mar 19, 2015

Recording of Innovation in Technical Communication keynote at tcworld India 2015 Mar 18, 2015

Podcast: The upcoming tcworld India conference on March 12-13, with Akash Dubey Feb 09, 2015

Best practices for API documentation -- podcast with Andrya Feinberg Feb 04, 2015

Survival strategies for API documentation -- slides and recording Feb 03, 2015

API workshop video + audio + slides + workshop files from TC Camp Jan 27, 2015

Moving from passive to reactive documentation -- recording of presentation by Greg Koberger, ReadMe.com founder Jan 19, 2015

Podcast: Unifying the API doc publishing toolchain, with Mark Baker Jan 08, 2015

Podcast: Automating REST API documentation, with Peter Gruenbaum Jan 05, 2015

Learning how developers think, and other API doc insights: Podcast with Joe Malin Dec 22, 2014

Getting a job in API documentation: Podcast with Andrew Davis Dec 17, 2014

The Author Experience -- Interview with Rick Yagodich Nov 05, 2014

Slides and recording for "Perfecting the audio narration in instructional video" at Info Dev World Oct 23, 2014

API Doc presentation slides and recording (San Francisco STC chapter) Oct 16, 2014

Information Development World and the Customer Experience -- A Podcast with Scott Abel and Val Swisher Jun 18, 2014

Introduction to API documentation: Interview with Scot Marvin Jun 16, 2014

Lessons learned as a novice API technical writer -- Interview with Mary Linderman (podcast) Jun 08, 2014

Creating code samples for API/SDK documentation (webinar recording, slides, and audio) May 30, 2014

Recording of my STC Sacramento presentation -- Why users can't find answers in help material May 18, 2014

Videos and reflections from the 2014 Intelligent Content Conference Mar 03, 2014

Tobi Crabtree on Virtual Agents (Intelligent Content 2014) Mar 03, 2014

Val Swisher on Translation Without Borders at Intelligent Content 2014 Mar 03, 2014

Noz Urbina on The Biological Imperative for Intelligent Content (Intelligent Content 2014) Mar 03, 2014

Mark Baker on Every Page Is Page One (Intelligent Content 2014) Mar 03, 2014

Rahel Bailie on the Language of Content Strategy (Intelligent Content 2014) Mar 03, 2014

Don Day on Connecting Intelligent Content with Micropublishing (Intelligent Content 2014) Mar 03, 2014

Theresa Putkey on Diagnosing and Solving Content Problems (Intelligent Content 2014) Mar 03, 2014

Kyle Wiens on gamification and iFixit / Dozuki at Intelligent Content 2014 Mar 03, 2014

Sarah O'Keefe on The Many Facets of Content Strategy (Intelligent Content 2014) Mar 03, 2014

Marcia Riefer Johnston on Writing (Intelligent Content 2014) Mar 03, 2014

Tom Johnson on Blogging (Intelligent Content 2014) Mar 03, 2014

Recording of STC Berkeley presentation on why users can't find answers in help Jan 08, 2014

Recording and slides for "Why users can't find answers in help" presentation to STC Silicon Valley Oct 23, 2013

Recording of "Video Tutorials for User Assistance" (UA Europe Presentation) Jun 24, 2013

Recording of "Making Content More Findable When Users Browse and Search" (UA Europe Presentation) Jun 24, 2013

Podcast: Include It All, Filter It Afterwards -- Interview with Mark Baker Dec 11, 2012

Webinar Recording: Designing Quick Reference Guides Feb 18, 2012

Webinar Recording -- Organizing Help Content: Breaking Out of Topic-Based Hierarchies Feb 18, 2012

Podcast: Organizing Help Content: Breaking Out of Topic-based Hierarchies May 18, 2011

Podcast: Content Strategy and Agility, with Noz Urbina Apr 05, 2011

Podcast: A Practical Guide to Information Architecture, with Donna Spencer Mar 18, 2011

Podcast -- Visual Composing: Document Design for Print and Digital Media, with Jo Mackiewicz Mar 14, 2011

Podcast with Alan Houser -- Candidate for STC Vice President Mar 07, 2011

Podcast with Victoria Koster-Lenhardt -- Candidate for STC Vice President Mar 07, 2011

Podcast: Educational Programs and Workplace Practices Nov 23, 2010

Why Help Content Fails and #contentstrategy Oct 22, 2010

Technical Writing Is More Than "Click This, Select That" [Podcast] Oct 21, 2010

Podcast: Finding and Creating Relevant Content -- Strategies for Social Media Oct 08, 2010

Podcast: Developing a Personal Voice in Audio (Intermountain-STC event) Oct 06, 2010

More Students Questions about Technical Writing Sep 07, 2010

Answers About the Field of Technical Writing for Students Sep 06, 2010

Podcast: From Overlooked to Center Stage (Overlooked) Apr 28, 2010

Podcast: “Anyone Can Write”: Changing Roles for Technical Communicators Apr 26, 2010

Podcast: Trends in Technical Communication Apr 25, 2010

Podcast: Ten Voiceover Techniques (PodcampSLC) Apr 11, 2010

Podcast: What's New in Flare 6 — Interview with Mike Hamilton Mar 02, 2010

Podcast: Documentation in the Cloud Mar 01, 2010

Podcast: Riding the Tide of Technical Communications Consulting Jan 21, 2010

Podcast on getting a job in technical writing (TW Job) Dec 26, 2009

Podcast: The Myth of Single Sourcing Dec 21, 2009

Podcast about the Podcast Poll Nov 18, 2009

Podcast on the seven deadly sins of blogging Nov 05, 2009

Podcast from BYU Idaho Professional Writing Panel Oct 15, 2009

Choosing Between Academic and Corporate Life: Did I Make the Wrong Choice? Oct 10, 2009

My STC Summit Blogging Presentation Is Free Oct 01, 2009

Information Overload -- Conversation with Ricardo Amigo Sep 23, 2009

Podcast with Anne Gentle about her Conversation and Community book Aug 26, 2009

Carcast: Friday Thoughts on Reading, Publish2, and Writer River Aug 14, 2009

Podcast on Content Strategy: Interview with Rahel Bailie Jul 27, 2009

Forms that Work – Interview with Caroline Jarrett (podcast) Jun 20, 2009

Blogging, Podcasting, and Screencasting: Eight Characteristics to Attract Devoted Followers [Part 2] Jun 14, 2009

Blogging, Podcasting, and Screencasting: Eight Characteristics to Attract Devoted Followers [Part I] Jun 14, 2009

Anne Gentle on her Forthcoming Book, Conversation and Community: The Social Web for Documentation May 27, 2009

STC Toronto's New Five-and-Five Chapter Model May 25, 2009

Richard Hamilton's XML Press Imprint May 25, 2009

Converting Readers from Casual Subscribers to Devoted Followers May 21, 2009

Madcap's Flare-DITA Solution (podcast) May 20, 2009

The State of Structured Authoring in Technical Communication (podcast) May 19, 2009

John Hedtke on Disaster Preparedness and Book Publishing May 16, 2009

GUI Magnets -- Prototyping User Interfaces with Simple Magnets May 13, 2009

James Bond: The History of the Illustrated 007 (Podcast with Alan Porter) May 11, 2009

Ginny Redish -- Letting Go of the Words (Podcast Interview at STC Summit) May 05, 2009

Introduction to Technical Writing (podcast) Mar 24, 2009

Managing Writers: Interview with Richard Hamilton (podcast) Mar 23, 2009

Jane's Presentation, Twitter for Business (podcast) Mar 15, 2009

Podcast -- Blogging for Technical Communicators Webinar (Part 2) Mar 04, 2009

Podcast -- Blogging for Technical Communicators Webinar (Part 1) Mar 03, 2009

Documentation Review Techniques (videocast) Feb 05, 2009

Podcast: Make Your Help Indispensable, Safeguard Your Job Jan 31, 2009

Screencasting -- Workflow and Presentation, by Collin Turner (Podcast) Jan 17, 2009

A Technical Writer with Extra Privileges? Responding to a Question about Roles (Videocast) Jan 15, 2009

Top Technical Communication News for January 2009 Jan 11, 2009

Podcast: Help Authoring with Doc-To-Help 2009, Interview with Nicky Bleiel Jan 05, 2009

Podcast: Technical Writing in Agile Environments -- Interview with Alyssa Fox Dec 23, 2008

Podcast: What Is the Technical Writer's Role in Interface Design? Interview with Bogo Vatovec Dec 14, 2008

Podcast: Debunking the Boredom Myth of Technical Writing Nov 03, 2008

Podcast: Personalities of Technical Communicators -- Interview with Deborah (Shapiro) Hemstreet Oct 29, 2008

Podcast: Repurposing Content for Multichannel Publishing (Single Sourcing) Sep 19, 2008

Podcast: Flare 4 -- Ten New Features, Interview with Sharon Burton Sep 08, 2008

Podcast: What's New in the Field of Technical Communication? Sep 05, 2008

Podcast: Using Video in Training and Documentation, Interview with Todd O'Neill May 31, 2008

Podcast: Analyzing Your Users and Needs Before Creating the Help Deliverables; Interview with Nicky Bleiel May 31, 2008

Podcast: How to Create User-Centered Documentation, Interview with Joe Sokohl May 30, 2008

Thinking About a More Personal Style of Podcasting May 27, 2008

Podcast: Workspaces, Collaboration, and Information Sharing -- Interview with Emma Hamer May 25, 2008

Podcast: Why Content Management Projects Fail, Interview with Rahel Bailie May 25, 2008

Podcast: How XML Enables Information Sharing and Reuse -- Interview with Joe Gollner May 25, 2008

Podcast: XSL, Flash, and Live Blogging -- Interview with Sarah O'Keefe May 17, 2008

Podcast: Document Engineering, Interview with Robert Glushko May 17, 2008

Podcast: Living Multiple Lives -- The New Technical Communicator, Interview with Noz Urbina May 11, 2008

Podcast: Embracing Wikis -- Interview with Stewart Mader May 10, 2008

Podcast: Moving 50,000 Pages of Unstructured Content to DITA May 06, 2008

Podcast: Leading Your Company into the Wikis, Blogs, and Social Networks of Web 2.0 May 06, 2008

Podcast -- DITA: From the Perspective of Someone Actually Using It Apr 21, 2008

Podcast -- Social Networking and the Value of User Communities for Technical Communicators Apr 12, 2008

Podcast -- Transitioning from Technical Writing into Usability Apr 02, 2008

Podcast -- Tackling Godzilla: A Writer/Usability Consultant Reflects on the Largest Project of her Career Mar 26, 2008

My Blogging and Podcasting Presentation -- the MP3 and Video Recording Mar 02, 2008

Interview with STC President Linda Oestreich: Directions the STC Is Heading Feb 05, 2008

Going Beyond Technical Writing: Practical Advice for Diversifying Your Skillset -- Podcast Interview with Mark Hanigan Jan 29, 2008

All About Madcap Flare: Podcast Interview with Paul Pehrson, MVP in Madcap Software Forums Jan 19, 2008

The Impact of Social Media on Technical Communication -- Podcast Interview with Bill Albing Jan 14, 2008

Technical Communication Suite from Adobe -- Interview with RJ Jacquez Dec 10, 2007

Show Me Demos and Captivate -- Interview with Kevin Siegel Dec 05, 2007

Special DMN Communications Podcast with Tech Writer Voices (me): Are you Hurting Your Career By Not Blogging or Podcasting? Nov 19, 2007

Top 10 Worst Things SMEs Say or Do -- Interview with Brenda Huettner Nov 12, 2007

Building Online Communities: Interview with Svi Ben-Elya about Elephant.org.il Nov 06, 2007

Answering Tough Questions About Wikis -- Interview with Anne Gentle Oct 16, 2007

Usability Research Behind Microsoft's Ergonomic Keyboard Oct 05, 2007

Location is everything when it comes to getting information from SMEs — Carcast Sep 20, 2007

Virtual Ways of Communicating — Char James-Tanny Sep 17, 2007

Information Architecture: Organizing Chaos, Metadata, Taxonomy vs. Folksonomy, and the Dublin Core Jun 21, 2007

A New Approach: Tech Comm News Jun 14, 2007

Vista and Office 2007: Presentation by David McNamee from Microsoft May 31, 2007

Podcasting at the STC Conference: Reasons, Methods, and Reflections May 19, 2007

STC Conference: Jack Molisani on Trends in Technical Communication May 19, 2007

STC Conference: Geoff Sauer on tc.eserver.org, the Largest Tech Comm Index Online May 19, 2007

STC Conference: Rob Houser on Creating Nontraditional E-Learning May 19, 2007

STC Conference: Scott Abel on Web 2.0 May 19, 2007

STC Conference: Ann Rockley on the Rockley Group Blog and a New CMS Report May 19, 2007

STC Conference: Chris Thompson on Searching for a Content Management System May 19, 2007

STC Conference: Caroline Jarrett on User Interface Design May 19, 2007

STC Conference: Harry Miller on Multimedia Documentation May 19, 2007

STC Conference: Stephanie Bryant on Videoblogging May 19, 2007

STC Conference: Mike Brazill on Writing for Developers May 19, 2007

STC Conference: John Daigle on RoboHelp 7 May 19, 2007

STC Conference: Debbie Kennedy on Modular Writing and Reusability May 19, 2007

STC Conference: Joan Lasselle on Adopting Content Management May 19, 2007

STC Conference: Cindy Skawinski on Activity Diagrams (Uniform Modeling Language Artifacts) May 19, 2007

STC Conference: Adrienne Escoe on Recruiting May 19, 2007

STC Conference: Teresa Lipus, Snake River chapter, Southern Idaho and Eastern Oregon May 19, 2007

STC Conference: Deanne Levander, Twin Cities, Minnesota Chapter, and John Garison, Vermont May 19, 2007

STC Conference: Laurel Bowen, Oakridge Tennessee Chapter May 19, 2007

STC Conference: Brad Simmons, Ames, Iowa May 19, 2007

STC Conference: Michael Gernes, Central Iowa STC Community May 19, 2007

Leadership Day: Jackie Damrau, Dallas, Texas, and Rachel Houghton, Willamette Valley, Oregon May 19, 2007

Leadership Day: Jeanette Rogers, Seattle, Instructional Design & Learning SIG May 19, 2007

Leadership Day: Lorrie Corbett, Philadelphia Metro Chapter May 19, 2007

Leadership Day: Hillary Hart, Austin Chapter May 19, 2007

Leadership Day: Todd Race, Toronto chapter, Canadian Issues Group May 19, 2007

Leadership Day: Dan Dornbrook, Chicago Chapter May 19, 2007

Leadership Day: Melanie G. Flanders, China; Beau Cain, Director 8 May 19, 2007

Leadership Day: Paul Sinasohn, Berkeley Chapter, California May 19, 2007

Leadership Day: Holly Harkness, Al Hood, and Howard Speck — Atlanta Chapter May 19, 2007

Leadership Day: Rhevati Sampath and Wendy Tung, Berkeley Chapter, California May 19, 2007

Leadership Day: Kelly Schrank & Lou Martindale — Mid-South Chapter in Memphis and Suncoast Chapter in Tampa May 19, 2007

Leadership Day: Sue Kloster, Willamette Valley Chapter, Oregon May 19, 2007

Creating Help in the Web 2.0 Age — Presentation by Neil Perlin May 10, 2007

Special Announcements: Add your blog to techwriterblogs.com wiki, and also support Tech Writer Voices May 08, 2007

Presentation on Writing and Web 2.0 by Keith Hoffman — Given at the University of Wisconsin May 08, 2007

Wikis Are Coming: An In-Depth Exploration of Using Wikis in Documentation — Interview with Katriel Reichman (Israel) May 06, 2007

A Few Conversations at Doc Train — User Personas, Data Conversion, and Simplified Technical English May 01, 2007

My First Carcast: Driving Home from Vancouver After the Doc Train Conference Apr 30, 2007

Managing Virtual Teams: Getting the Most from Wikis, Blogs, and Other Collaborative Tools — Interview with the authors Apr 29, 2007

Interview with George Hayhoe, editor of Technical Communication Journal, on Technical Writing in China and Korea Apr 25, 2007

Defining Experiences: Five STC Candidates Share Influential Stories from the Tech Comm Field Apr 08, 2007

Making Help More Human, and other discussions Apr 07, 2007

Susan Burton Provides an Inside, In-Depth Look at STC's Most Pressing Issues Apr 02, 2007

Special STC Elections Podcast: Interview with Nicky Bleiel, Candidate for Director Mar 25, 2007

Is Technical Writing Boring? Tech Writers as Information Architects Mar 14, 2007

Online Communities, Member Maps, Virtual Chats, Sparkpeople, Intercom, and More Mar 07, 2007

Review of Word 2007, Tool vs. Industry Experience, the Slow Movement, E-mail Tips, and More Feb 27, 2007

First Cohost Podcast — A Natural Conversation about Technical Writing Feb 14, 2007

Discussion about RoboHelp 6 — Interview with Rick Stone Feb 03, 2007

How to Create a Site Where Users Can Actually Find Information — Interview with Thom Haller Jan 23, 2007

Ten Lessons Learned as a Technical Communicator — Interview with Rahul Prabhakar Jan 13, 2007

Mike Hamilton Gives Flare Demo to the Suncoast Chapter Jan 05, 2007

The Convergence of Web 2.0 with Help Documentation — Tom Johnson Jan 03, 2007

Understanding Principles of Usability, Part 2 — Karen Bachmann Jan 01, 2007

Understanding Principles of Usability, Part 1 — Karen Bachmann Dec 18, 2006

Web 2.0, CMS, and DITA — Interview with Ann Rockley Nov 27, 2006

How to Increase Collaboration and Performance — Interview with Emma Hamer Nov 13, 2006

Technical Writing in India — Interview with Sandeep Balakrishna Oct 30, 2006

Another Perspective on Single-Sourcing — Interview with Sarah O'Keefe Oct 23, 2006

How To Create a Usable Index — Interview with John McGhie Oct 20, 2006

Podcasting 101 — by Tom Johnson Oct 17, 2006

How to Implement Single Sourcing — Interview with Neil Perlin Oct 09, 2006

Joomla, an Open-Source Content Management System Solution — Interview with Sean Wheller about Joomla Oct 09, 2006

Knowledge Management and Technical Writing — Janet Foley Oct 09, 2006

Flare 2.0 and MadCap Software — Interview with Mike Hamilton Oct 09, 2006

Content Management Professionals — Interview with Scott Abel Oct 09, 2006

Writing for the Web — Ian Koss, Founder of Ink19.com Oct 09, 2006

Our TOPPODCAST Picks

Follow Us

Stay Connected

I’d Rather Be Writing Podcast

Related Podcasts

Links

Stay Connected