Topic-based authoring

Edit links
Source: Wikipedia, the free encyclopedia.

In

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:

  • 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". norman.walsh.name. Retrieved 21 June 2012.
  2. ISBN 978-0-557-07291-0
    .
  3. ISBN 978-0-429-05961-2, retrieved 2023-11-10{{citation}}: CS1 maint: location (link
    )
  4. ISBN 978-0-262-51295-4
    .
  5. ISBN 978-0-471-30635-1
    .

External links


Stub icon

This article relating to communication is a stub. You can help Wikipedia by expanding it.

Retrieved from "https://en.wikipedia.org/w/index.php?title=Topic-based_authoring&oldid=1218121589"