Design expert Donald Norman has written that when people are anxious, they tend to narrow their thought processes. Conversely when people are happy, they become more creative and imaginative at solving problems. If this is true, it means that one of the best things a technical writer can do is create beautiful content that moves readers to a happier, more adaptive emotional state. Or so I contend.
For technical writers, content reuse it a great idea---but way more difficult in practice than it sounds. Here are some of my practical suggestions on how to do it in a sustainable way, based on my years of experience implementing it with tools like Confluence and Madcap Flare.
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?