I just published an article on how documentation can enable sales. Here's an annotated list of the resources I used in my research.
Tag: technical writing
What It’s Like to Work in Technical Writing [Email Interview]
A student from my alma mater reached out to me with questions about the wonderful world of technical communication. Here's a transcript (peppered, of course, with delightful Dilbert comics).
The Prodigal Son: Update March 4, 2019
Lent, Rembrandt, and updates on various writing projects (just submitted another article, yay!). Recommended readings on MLK and celibacy.
What I’m Up To: February 25, 2019
From the day I started this blog, I haven't committed to a strict blogging cadence. Until I do that (and I really should), if I don't have any well-formed thoughts to publish, I'll settle instead for giving a brief update on what I'm reading and working on.
My Article from STC Intercom: A Cost-Free Method of Archiving Wiki Pages in Confluence
Of all the boring subjects in the world, page archiving has got to be the most boring one of all. But for organizations whose content starts getting out of control, it's a critical problem to solve. Here's how my team tackled it in a low-cost way.
Do Technical Writers Dream of Arbortext Editor?
Arbortext Editor is a software program that lets you do "structured writing"---a special kind of writing in which every piece of content you compose follows one or more predefined rules. In theory this helps writers to develop consistent, high-quality content. The problem is that the tool has a lot of serious shortcomings. Here's my wishlist of things to improve.
My Article from STC Intercom: Designing Wiki Templates for Today’s Web
Last November I published an article in Intercom, a magazine produced by the Society for Technical Communication. It was paywalled at the time, but the exclusive rights period has since expired so I have copied it here. Synopsis: A regular part of the technical writer's job is to design document templates that help others jumpstart the writing process. How do our template design strategies change as more documentation moves from the print medium to web browsers and mobile devices?
