Good communication has always been about understanding your audience — shaping your message to match how they think, what they need, and what they’ll do with it. Information typing, the “IT” in the technical documentation standard DITA, codifies that practice into a design discipline that organizes content around its function rather than its form. Rob […]
technical writing
Manny Silva: Docs as Tests for Resilient Technical Documentation – Episode 213
Technical documentation of software products is critical work that needs to accurately inform end users, regardless of how quickly and substantially the software might be changing. Manny Silva has created the Docs as Tests, a system that integrates a set of well-developed practices and a collection of engineering tooling, to help technical communicators streamline and […]
Michael Priestley: Creator of the DITA Structured-Content Standard – Episode 192
Twenty-four years ago at IBM, the company’s commitment to user-focused content led to the decision to develop a standard way of structuring content so that it could be used in multiple channels. Michael Priestley was uniquely positioned to guide the team that created the technical approach to the corporate standard that would ultimately become DITA, […]
Tom Johnson: Documenting APIs – Episode 88
Documenting APIs is one of the newer jobs in the technical writing domain. Tom Johnson enjoys the unique challenges of collaborating with and writing for the developers who create and use these Application Programming Interfaces. He also enjoys reflecting on his work and sharing his insights with his fellow technical communicators. We talked about: his […]
Hannah Kirk: Connecting Technical Writing and Content Strategy – Episode 70
Hannah Kirk has great ideas about how technical writing and content strategy can support each other. She’s not a typical tech writer. She loves and appreciates technical documentation and enjoys practicing it. But she has always been more interested in strategy. And she has always spent a lot of time thinking about how content is […]
Jack Molisani: Content Strategy Events – Episode 66
Jack Molisani knows how to put on an engaging and edifying professional conference. He founded and organizes the LavaCon technical content strategy conference, which draws hundreds of content professionals to cities like New Orleans and Portland each year. Jack has experimented over the years with virtualizing parts of his conferences, and he shares in this […]
Andrea Ames: Content Strategy Leadership – Episode 63
Andrea Ames has been a content leader for more than 35 years. From her early work as a technical writer, she has gone on to guide huge content teams and to become an advisor to other content leaders. Some folks might get jaded after three and a half decades in huge enterprises. Not Andrea. Her […]