Topic-based authoring explained

In technical communication, topic-based authoring or topic-based writing is a modular approach to content creation where content is structured around topics that can be mixed and reused in different contexts. It is defined in contrast with book-oriented or narrative content, written in the linear structure of written books.[1]

Topic-based authoring is popular in the technical publications and documentation arenas, as it is especially suitable for technical documentation. Tools supporting this approach typically store content in XHTML or other XML formats and support content reuse, management, and the dynamic assembly of personalized information.

Topics

A topic is a discrete piece of content that:

Topics can be written to be independent of one another and reused wherever needed.

History

Following the technology revolution of the 1990s, technical communicators were employed to convey technical information to the new, rapidly growing population of technical users. This began with the use of manuals, but those were not widely well received as did not meet the accelerated speed at which the users desired information. In 1998, John M. Carroll developed the writing concept of minimalism which provided shorter and more streamlined instruction for the user to access quickly.[3] The publication of William Horton's Designing and Writing Online Documentation introduced the development of online help. Online help's content is topic-oriented, using conceptual and procedural topics to build its structure.[4]

In 2005, the Darwin Information Typing Architecture was published to help authors create topic-based structured content. The standard is managed by the Organization of the Advancement of Structured Information Standards DITA Technical Committee.

See also

External links

Notes and References

  1. Web site: Topic-oriented authoring. Norman Walsh. norman.walsh.name. 5 February 2007. 21 June 2012.
  2. Book: Rockley, Ann . DITA 101: fundamentals of DITA for authors and managers . Manning . Steve . Cooper . Charles . 2009 . The Rockley Group . 978-0-557-07291-0 . Schomberg, ON.
  3. Book: Minimalism beyond The Nurnberg Funnel . 1998 . MIT Press . 978-0-262-51295-4 . Carroll . John M. . Cambridge.
  4. Book: Horton, William K. . Designing and writing online documentation: hypermedia for self-supporting products . Wiley . 1990 . 978-0-471-30635-1 . 2nd . Wiley technical communication library . New York, NY . en.