Tag Archives: DITA

Is Structured Authoring (like DITA) a Good Fit for Publishing on a Website?

5/22 update: This post generated a lot of controversy, and I believe part of the controversy could have been avoided if I had articulated my ideas better. I’ve gone through and updated parts of this post by adding notes. My additions appear in green. The previous title was “Structured Authoring Versus the Web”. However, of Continue Reading »

Does DITA Encourage Authors to Fragment Information into a Million Little Pieces?

For an updated post on this topic, see DITA’s output does not require you to separate tasks from concepts. I’m currently exploring the possibility of authoring content in DITA (using a tool such as easyDITA), publishing to an HTML web help output (through the DITA Open Toolkit), and then importing the output into Drupal (through Continue Reading »

Unconscious Meaning Suggested from the Structure and Shape of Help

I’m continuing to make my way through James Kalbach’s book, Designing Web Navigation. In chapter 2, he says the structure and format of content helps users anticipate the meaning of the content. He writes, The human visual system naturally seeks structure in information, often very rapidly. Scientists refer to this as “pre-attentive” processing. This occurs Continue Reading »

Guest Post: Why I Love Wikis

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 Continue Reading »