Software documentation: from instruction to integration

Abstract

The field of software documentation is reviewed by examining manual writing before and after 1985. Changes in the field include an increased emphasis on satisfaction of users, improved management strategies and improved design techniques. Three books on software documentation published since 1988 are surveyed, and it is argued that the trends after 1985 reinforce a social constructionist view of documentation.< <ETX xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:xlink="http://www.w3.org/1999/xlink">></ETX>

Journal
IEEE Transactions on Professional Communication
Published
1990-12-01
DOI
10.1109/47.62811
CompPile
Open Access
Closed
Topics
Export

Citation Context

Cited by in this index (2)

  1. Technical Communication Quarterly
  2. Journal of Technical Writing and Communication

References (39)

  1. Text ConText and Hypertext
  2. Software Manual Production Simplified
  3. Document design from 1980 to 1989: Challenges that remain
    Technical Communication
  4. Effective Documentation What We Have Learned from Research
  5. Effective Documentation What We Have Learned from Research
Show all 39 →
  1. Effective Documentation What We Have Learned from Research
  2. How to Write a Usable User Manual
  3. Writing User-Usable Manuals A Practical Guide to Preparing User-Friendly Computer Hardware and Software Documentation
  4. Developing Effective User Documentation A Human-Factors Approach
  5. 10.1037/11324-012
  6. Effective Documentation What We Have Learned from Research
  7. Effective Documentation What We Have Learned from Research
  8. Effective Documentation What We Have Learned from Research
  9. The Soft Side of Software A Management Approach to Computer Documentation
  10. Effective Documentation What We Have Learned from Research
  11. How to Write Computer Documentation for Users
  12. Creating Effective Documentation for Computer Programs
  13. Creating Computer Software User Guides From Manuals to Menus
  14. Effective Documentation What We Have Learned from Research
  15. Text ConText and Hypertext
  16. Text ConText and Hypertext
  17. Effective Documentation What We Have Learned from Research
  18. Trans Anita Tenzer and Davis Elkind
  19. The Society of Text Hypertext Hypermedia and the Social Construction of Information
  20. Writing Better Computer User Documentation
  21. How to write a computer manual A handbook of software documentation
  22. Text ConText and Hypertext
  23. 10.2307/376723
  24. Guide to Effective Software Technical Writing
  25. Text Context and Hypertext Writing with and for the Computer
  26. Text ConText and Hypertext
  27. 10.2190/POS
  28. How to Write a Really Good User's Manual
  29. Effective Documentation What We Have Learned from Research
  30. Text ConText and Hypertext
  31. Effective Documentation What We Have Learned from Research
  32. Text ConText and Hypertext
  33. The Society of Text Hypertext Hypermedia and the Social Construction of Information
  34. Soft Words Hard Words A Common-Sense Guide to Creative Documentation