Get 20M+ Full-Text Papers For Less Than $1.50/day. Start a 14-Day Trial for You or Your Team.

Learn More →

Rethinking documentation and interface: reflections on categorical approaches

Rethinking documentation and interface: reflections on categorical approaches Commentary 12 A closer look at Winogradg examples reveals much. Rethinking Documentation and Interface: Reflections on Categorical Approaches Dennis Wixon MS-A-1148 Microsoft Corporation 5600 148th Street NE Redmond, WA 98052 denniswi@microsofl.com ! found Dr. Winograd's paper thought provoking and at times frustrating. Frustrating because I would have liked to ask him about the implications of his examples. Consequently, I'd like to draw out some of the implications I saw in Dr. Wingrad's examples. I agree with Dr. Winograd that "every linguistic act is conversation" and my intention here is to begin a broader conversation about the nature of documentation and interfaces. On seeing the table contrasting interaction with documentation, my first question was what is the dimension or category that underlies each of the rows? Here are my suggestions: Starting with a classic reference manual, the author makes few assumptions about the goals of the audience; the communication is oriented toward completeness (e.g., here are all the parameters of the command). Similarly, the author of a manual makes few assumptions about the context of use, since the object is described completely so this information can be applied in any context. The manual is permanent and offers its own http://www.deepdyve.com/assets/images/DeepDyve-Logo-lg.png ACM SIGDOC Asterisk Journal of Computer Documentation Association for Computing Machinery

Rethinking documentation and interface: reflections on categorical approaches

Loading next page...
 
/lp/association-for-computing-machinery/rethinking-documentation-and-interface-reflections-on-categorical-fkV5S20wQo

References

References for this paper are not available at this time. We will be adding them shortly, thank you for your patience.

Publisher
Association for Computing Machinery
Copyright
Copyright © 1999 by ACM Inc.
ISSN
0731-1001
DOI
10.1145/339119.339128
Publisher site
See Article on Publisher Site

Abstract

Commentary 12 A closer look at Winogradg examples reveals much. Rethinking Documentation and Interface: Reflections on Categorical Approaches Dennis Wixon MS-A-1148 Microsoft Corporation 5600 148th Street NE Redmond, WA 98052 denniswi@microsofl.com ! found Dr. Winograd's paper thought provoking and at times frustrating. Frustrating because I would have liked to ask him about the implications of his examples. Consequently, I'd like to draw out some of the implications I saw in Dr. Wingrad's examples. I agree with Dr. Winograd that "every linguistic act is conversation" and my intention here is to begin a broader conversation about the nature of documentation and interfaces. On seeing the table contrasting interaction with documentation, my first question was what is the dimension or category that underlies each of the rows? Here are my suggestions: Starting with a classic reference manual, the author makes few assumptions about the goals of the audience; the communication is oriented toward completeness (e.g., here are all the parameters of the command). Similarly, the author of a manual makes few assumptions about the context of use, since the object is described completely so this information can be applied in any context. The manual is permanent and offers its own

Journal

ACM SIGDOC Asterisk Journal of Computer DocumentationAssociation for Computing Machinery

Published: Nov 1, 1999

There are no references for this article.