Structured writing
From Wikipedia, the free encyclopedia
Structured writing is a form of technical writing that leverages decades of research into documentation best practices.
The term was coined by Robert E. Horn and became a central part of his Information Mapping method of analyzing, organizing, and displaying knowledge in print and in the new online presentation of text and graphics.
Horn and colleagues identified dozens of common documentation types, then analyzed them into structural components called information blocks. They identified over 200 common block types. These were assembled into information types using information maps.
The seven most common information types were concept, procedure, process, principle, fact, structure, and classification.
These types are loosely related to the three basic information types in Darwin Information Typing Architecture - concept, task, and reference. An Information Mapping procedure is a set of steps for a person. A process is a set of steps for a system. Both resemble the DITA task.
DITA topics are assembled into documents using DITA maps.
[edit] References
- Horn, Robert E. (1989). Mapping Hypertext: The Analysis, Organization, and Display of Knowledge for the Next Generation of On-Line Text and Graphics. Lexington Institute.
- Horn, Robert E. (1992). How High Can it Fly? Examining the Evidence on Information Mapping's method of High-Performance Communication. Lexington Institute.
[edit] External links
- DITA Users - a member organization helping people get started with topic-based structured writing.
