Tag Archives | DITA

Woman eating pizza

Confusing Analytic and Synthetic Truths in Defining Topic Types

Ray Gallon’s recent post, Let’s Break a Tech Comm Rule proposes that we should rethink the idea of separating tasks from concepts. Hooray! It’s no secret that I’m no fan of this separation. Reading Ray’s post, also sparks this thought. It is a common and sometimes catastrophic error to confuse an analytic truth with a synthetic truth. That […]

Continue Reading
Margaret_Roper,_by_Hans_Holbein_the_Younger

We Must Develop Topic-Based Information Design

This entry is part 4 of 5 in the series Tyranny of the terrible troica: task concept and reference reconsideredThere is a lot of talk in tech comm today about topic-based writing, but very little about topic-based information design. This is a problem, because, in the age of the Web, and particularly of the mobile […]

Continue Reading

The Tyranny of the Terrible Troika: Rethinking Concept, Task, and Reference

This entry is part 1 of 5 in the series Tyranny of the terrible troica: task concept and reference reconsideredTom Johnson’s blog post Unconscious Meaning Suggested from the Structure and Shape of Help, includes a graphic showing three shapes of content: Tom Johnson’s “Shapes of Help” graphic. These three shapes are meant to represent the DITA […]

Continue Reading