TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:Re: Resources for learning Structured Writing? From:Yves Barbion <yves -dot- barbion -at- gmail -dot- com> To:Stuart Burnfield <slb -at- westnet -dot- com -dot- au> Date:Tue, 21 Oct 2014 12:20:49 +0200
Hmmm... interesting. Thank you for the pointers to the in-depth
A source? Well, yes actually, and it's the same source which was mentioned
earlier in this thread: the excellent book "Developing Quality Technical
On page 129, I read: "Research on short-term memory that George Miller
reported in 1956 indicated that people can remember seven items plus or
And on page 130: "The traditional guidelines on the number of items in a
list that users need to remember are:
- Seven items maximum for online documentation
- Nine items maximum for printed documentation"
And, Stuart, you're right in saying that the book is about how to develop
quality technical information, not "tech writing the DITA way", but the
lead author of the book was Gretchen Hargis, who was "a pioneer of IBM
Darwin Information Typing Architecture (DITA)". Indeed, DITA is not
mentioned in the book (and it's not mentioned in the index), but it is a
very good book on topic-based authoring. And the DITA information types
concept, task, reference are described on page 218.
You're "looking for a way to learn Information Mapping, WITHOUT going
through the "official" Information Mapping company"? Hmmm, I don't think
that's possible, so yes, I think you are looking for something that does
not exist. But then again, you don't need to learn Information Mapping if
you want to do structured writing (or use DITA). Just learn the best
practices of structured authoring, which are described in the books
mentioned in this thread.
On Tue, Oct 21, 2014 at 4:45 AM, Stuart Burnfield <slb -at- westnet -dot- com -dot- au>