Experience paper: a content reuse documentation design experience

  • Authors:
  • Kathy Haramundanis;Larry Rowland

  • Affiliations:
  • Hewlett-Packard Company, Nashua, NH;Hewlett-Packard Company, Ft. Collins, CO

  • Venue:
  • SIGDOC '07 Proceedings of the 25th annual ACM international conference on Design of communication
  • Year:
  • 2007

Quantified Score

Hi-index 0.00

Visualization

Abstract

Using an XML environment, these authors as co-writers developed a set of documents that reused content in several ways. The documents produced for a HP software product included a user manual, context-sensitive help for product GUI screens and user tasks, manual pages (manpages) for delivery on a UNIX system, a white paper, and a technical web site. The help system was delivered using a platform independent, HTML-based technology, manpages were delivered in NROFF for the man command, and the user manual was delivered as PDF and HTML on docs.hp.com and as PDF with the product. Reused content was authored in context within the documents and reused opportunistically rather than from a central repository.