Frankenbooks Must Die: A Rant

I was astonished at Sarah Maddox’s statement, in her guest post Why don’t technical writers use wikis — or do they? on I’d Rather be Writing, that wikis are not good at topic-based writing. Huh? Wikis are all about topic-based writing. In fact, it is the only type of writing they really support.

What’s wrong here? It certainly isn’t that Sarah does not understand wikis. If you want to know about using wikis in technical documentation, Sarah is the first person you want to talk to. If anyone knows wikis, it’s Sarah. She’s even written a book on the subject. What’s wrong, apparently, is that the term “topic-based writing” seems to have been corrupted or co-opted and robbed of its proper meaning. This is serious, and it needs to be fixed. read more

The Segmentation of Tech Comm

Segmentation

There is a growing segmentation of the tech comm profession.

I was flattered that my post Technical Communication is not a Commodity was used as a catalyst for Scott Abel’s discussion with Val Swisher, Jack Molisani and Sarah O’Keefe on The Changing Face of Technical Communications, What’s Next? I had a fair amount to say in the comment stream that followed to defend my assertion that Tech Comm is indeed not a commodity, but since then a few other interactions have convinced me that there is another important trend in tech comm that should be recognized: the growing segmentation of the field. read more

The Web Does Minimalism

It struck me today that the Web does Minimalism. Not only does it do it, it does it naturally, and it does it well. Consider:

Here’s a common listing of the principle tenants of minimalism (borrowed from http://www.ryerson.ca/~ipederse/Minimalism.htm via Google):

  • Take An Action-Oriented Approach
  • Aim for Guided Exploration
  • Position the Documentation in the Task Domain
  • Support Error Recognition and Recovery
  • Design For Non-linear Reading
  • Embrace the Motto: Less Is more
  • read more

    Introducing the SPFE Architecture

    Today, I am announcing the launch of a new website, SPFE.info. SPFE.info is a site about the SPFE architecture for building structured authoring systems. Why would the world, need such a thing when it already has DITA? The site will attempt to answer that. Why have I spent the last 15 years or so working on what I now call SPFE? That I will try to explain here.