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 is, it is an error to confuse a truth about how to analyse something into its parts with a truth about how that thing should be organized and presented to users. read more

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

Tom 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. Tom Johnson’s “Shapes of Help” graphic.

These three shapes are meant to represent the DITA topic triad of concept, task, and reference. I didn’t get it. As I said in a comment on Tom’s blog, I was trying to match the shapes to something more specific. It was odd that I didn’t recognize them as concept, task, and reference, I said, because I have be “battling the tyranny of the terrible troika” for the last few years. Tom asked what I meant by “the tyranny of the terrible troika”; this is my answer. read more