Jump to content

Structured writing

From Wikipedia, the free encyclopedia
This is an old revision of this page, as edited by Piotrus (talk | contribs) at 00:20, 15 September 2012 ({{stub}}). The present address (URL) is a permanent link to this revision, which may differ significantly from the current revision.

Structured writing is a form of technical writing that uses and creates structured documents.

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.

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.
  • DITA Users - a member organization helping people get started with topic-based structured writing.