Structured writing

Structured writing

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.

References

*
*

External links

* [http://www.ditausers.org DITA Users] - a member organization helping people get started with topic-based structured writing.


Wikimedia Foundation. 2010.

Игры ⚽ Нужно сделать НИР?

Look at other dictionaries:

  • Structured programming — can be seen as a subset or subdiscipline of procedural programming, one of the major programming paradigms. It is most famous for removing or reducing reliance on the GOTO statement.Historically, several different structuring techniques or… …   Wikipedia

  • Structured storage — (variously also known as COM structured storage or OLE structured storage ) is a technology developed by Microsoft as part of its Windows operating system for storing hierarchical data within a single file. Strictly speaking, the term structured… …   Wikipedia

  • Structured Liberal Education — (SLE) (pronounced slee ) is an academically demanding program at Stanford University that offers an alternative three course sequence for freshmen to fulfill their Introduction to the Humanities (IHUM) and Program in Writing and Rhetoric (PWR)… …   Wikipedia

  • Structured wiki — Structured wikis provide database like manipulation of fields stored on pages, and usually offer an extraction and presentation language or markup with functionality somewhat similar to SQL. Introduction Wikis are typically used as shared… …   Wikipedia

  • Structured English — Overview Structured English is the marriage of English language with the syntax of structured programming. Thus structured English aims at getting the benefits of both the programming logic and natural language. Program logic helps to attain… …   Wikipedia

  • Writing process — The Writing process is both a key concept in the teaching of writing and an important research concept in the field of composition studies. Research on the writing process (sometimes called the composing process) focuses on how writers draft,… …   Wikipedia

  • Technical writing — Technical writing, a form of technical communication, is a style of formal writing, used in fields as diverse as computer hardware and software, chemistry, the aerospace industry, robotics, finance, consumer electronics, and biotechnology. Good… …   Wikipedia

  • Academic writing — In academia, writing and publishing is conducted in several sets of forms and genres. This is a list of genres of academic writing. It is a short summary of the full spectrum of critical macademiac writing. It does not cover the variety of… …   Wikipedia

  • Medical writing — is the activity of producing scientific documentation by a specialized writer. The medical writer typically is not one of the scientists or doctors who performed the research. A medical writer, working with doctors, scientists, and other subject… …   Wikipedia

  • Objective structured clinical examination — For other uses, see OSCE (disambiguation). An Objective Structured Clinical Examination (OSCE) is a modern[1] type of examination often used in health sciences (e.g. Midwifery, orthoptics, optometry, medicine, chiropractic, physical therapy,… …   Wikipedia

Share the article and excerpts

Direct link
Do a right-click on the link above
and select “Copy Link”