Topic-based authoring

Summary

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 edit

A topic is a discrete piece of content that:

  • focuses on one subject,
  • has an identifiable purpose,
  • does not require external context to understand,
  • answers a single question, and
  • can be used for multiple purposes.[2]

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

History edit

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.[3] In 1998, John M. Carroll developed the writing concept of minimalism which provided shorter and more streamlined instruction for the user to access quickly.[4] 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.[5]

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 edit

References edit

  1. ^ Norman Walsh (5 February 2007). "Topic-oriented authoring". norman.walsh.name. Retrieved 21 June 2012.
  2. ^ Rockley, Ann; Manning, Steve; Cooper, Charles (2009). DITA 101: fundamentals of DITA for authors and managers. Schomberg, ON: The Rockley Group. ISBN 978-0-557-07291-0.
  3. ^ Cleary, Yvonne (2020-01-31), "Teaching Topic-based Writing", Teaching Content Management in Technical and Professional Communication, New York, NY : Routledge, 2020. | Series: ATTW book series in technical and professional communication: Routledge, pp. 72–86, ISBN 978-0-429-05961-2, retrieved 2023-11-10{{citation}}: CS1 maint: location (link)
  4. ^ Carroll, John M., ed. (1998). Minimalism beyond The Nurnberg Funnel. Cambridge: MIT Press. ISBN 978-0-262-51295-4.
  5. ^ Horton, William K. (1990). Designing and writing online documentation: hypermedia for self-supporting products. Wiley technical communication library (2nd ed.). New York, NY: Wiley. ISBN 978-0-471-30635-1.{{cite book}}: CS1 maint: date and year (link)

External links edit

  • DITA Users – a member organization helping people get started with topic-based structured writing
  • OASIS DITA Focus Area – the official OASIS DITA community