I was rereading some material in the long-running do-people-read-the-manual debate (such as Tom Johnson’s If No One Reads the Manual, That’s Okay), and it struck me that there is an assumption that people on both sides of this debate are making which deserves some scrutiny. We all assume that technical documentation operates at first hand.… Read More »
Conventional wisdom tells us that the best place for a needle is in a needle case, and the best place for hay is in a haystack. If you want to find something, or want other people to find it, you should put it in the right place. As we were all taught: a place for… Read More »
Everyone agrees that we should be writing in topics. (Okay, not everyone, probably, but everyone who is likely to read this blog.) Everyone agrees we should write in topics. But no one agrees on what a topic is. Actually, that’s not entirely true. When asked to describe what a topic is, almost everyone in the… Read More »
Just back from JoAnn Hackos’ CMS/DITA conference, where it became clear that even in a conference dedicated to a topic-based authoring methodology, most people are still writing books. Certainly, they are writing them in the form of topics, but then stitching them together into books. The fundamental product is still a book.