Author Archives: Mark Baker

A sea change

This blog will be undergoing a sea change. For those not familiar with the term: Full fathom five thy father lies;Of his bones are coral made;Those are pearls that were his eyes;Nothing of him that doth fade,But doth suffer a sea-changeInto something rich and strange.  Shakespeare, The Tempest The rich and strange part may be… Read More »

Designing for Feedback

We were discussing the biggest challenges in Tech Comm at the last STC Toronto brunch and we all seemed to agree that the difficulty getting feedback on the effectiveness of the content we create is the biggest challenge. The things that really matter in technical communication is whether users can achieve their goals after finding… Read More »

Designing topic types

A number of readers have asked me to write about how to design a topic type. Although it can sound complicated, especially if your bring XML schema definitions into the mix, designing a topic type is actually pretty simple. Before we begin, though, set aside all the issues around XML. XML has nothing to do with… Read More »

Don’t Lean on Development’s Agile Process

Don’t just try to fit into development’s agile process. Create your own lean content development process. Technical writers are increasingly finding themselves involved in the agile process of the development organization.  The most common way this happens is that a writer gets assigned to the team for a sprint and is expected to produce documentation… Read More »