Constructing usable documentation
Author:
Open Access
- 1 October 1999
- conference paper
- Published by Association for Computing Machinery (ACM)
- p. 22-25
Abstract
This study suggests that computer documentation is a complex technical communication genre, encompassing all the texts that mediate between complex human activities and computer processes. Drawing on a historical study, it demonstrates that the varied forms given to documentation have a long history, extending back at least to the early days of commercial mainframe computing. The data suggests that (1) early forms of computer documentation were borrowed from existing genres, and (2) official and unofficial documentation existed concurrently, despite efforts to consolidate these divergent texts. The study thus provides a glimpse into the early experimental nature of documentation as writers struggled to find a meaningful way to communicate information about their organization's developing computer technology.Keywords
This publication has 4 references indexed in Scilit:
- “Applied Constructivism” for User DocumentationJournal of Business and Technical Communication, 1998
- Rethinking Genre in School and SocietyWritten Communication, 1997
- Rethinking Genre from a Sociocognitive PerspectiveWritten Communication, 1993
- Genre as social actionQuarterly Journal of Speech, 1984