Topic-based authoring

From HandWiki
Short description: Structural approach to information publishing

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.

The Darwin Information Typing Architecture is a standard designed to help authors create topic-based structured content. The standard is managed by the Organization for the Advancement of Structured Information Standards DITA Technical Committee.

Topics

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

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

References

  1. Norman Walsh (5 February 2007). "Topic-oriented authoring". http://norman.walsh.name/2007/02/05/painting. 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, http://dx.doi.org/10.4324/9780429059612-4, retrieved 2023-11-10 
  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) (in en). 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. 

External links