ACM SIGDOC Asterisk Journal of Computer Documentation
An electronic publishing spectrum: a framework for text modules
SIGDOC '96 Proceedings of the 14th annual international conference on Systems documentation: Marshaling new technological forces: building a corporate, academic, and user-oriented triangle
A model for document management
Computer Communications
| Hi-index | 0.00 |
In his article "Object-Oriented Documentation," Johannes Sametinger describes a successful case study of creating object-oriented documentation. It is clear, however, that of the three types of documentation that he identifies, system documentation is the only one suited to this application. We argue that system documentation can afford to behave like the system it describes, but that user documentation needs to be organized according to the tasks users will do instead of according to how the system is structured. On the other hand, using a brother definition of object-oriented documentation presents technical communicators with a powerful model for information development that is beneficial to both the writer and the reader.