The following is a guest post by Neal Kaplan, a technical writer at Zuora, Inc. Another post about wikis? Why not! Wikis are great! Just to set the stage, I’ve been a technical writer for a while now, working for software companies in Silicon Valley. (In fact, I often forget that there are technical writers who don’t document software.) I’ve worked at large companies, where … more »

With my recent reflections on long versus short text, a comment by Michael O’neil made me wonder whether the “reading to do” mode equated with DITA’s task type, and whether the “reading to learn” mode equated to DITA’s concept type. In researching this, I stumbled across a goldmine of an article on the History of DITA. The article (mostly by Bob Doyle) traces the evolution … more »

I recently attended an STC chapter presentation on interface design, and the speaker, Grant Skousen, showed us the following graphic.

Last week I made some alterations to my site’s design, but no one seemed to notice. In fact, few people have ever commented about my blog’s design at all. The same goes with the music intros for my podcasts. I can change the music each time, and no one ever responds. In contrast, if a post has good content, I see a steady stream of … more »

Quick-Start Guides Require a Minimalist Mindset