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

Learn More →

Consequences of the engineering approach to technical writing

Consequences of the engineering approach to technical writing In a series of publications, Edmond Weiss describes the change in both programming and technical writing from an artistic craft to an engineering discipline. The change brought numerous benefits to the users and readers, to the programmers and writers, and to the companies they work for. In exchange for those benefits, Weiss says, writers had to give up control over the content and format of the documentation. They also lost the esthetic pride of creating a work of art and the personal satisfaction of teaching and protecting the reader. Weiss anticipates a future in which technical documentation is generated automatically and the technical documentor's job is merely to feed information databases. In the conclusion, I note a few differences of opinion, but overall I agree with Weiss's view. http://www.deepdyve.com/assets/images/DeepDyve-Logo-lg.png ACM Journal of Computer Documentation (JCD) Association for Computing Machinery

Consequences of the engineering approach to technical writing

Loading next page...
 
/lp/association-for-computing-machinery/consequences-of-the-engineering-approach-to-technical-writing-X0M40PhLjB
Publisher
Association for Computing Machinery
Copyright
Copyright © 2002 by ACM Inc.
ISSN
1527-6805
DOI
10.1145/584731.584737
Publisher site
See Article on Publisher Site

Abstract

In a series of publications, Edmond Weiss describes the change in both programming and technical writing from an artistic craft to an engineering discipline. The change brought numerous benefits to the users and readers, to the programmers and writers, and to the companies they work for. In exchange for those benefits, Weiss says, writers had to give up control over the content and format of the documentation. They also lost the esthetic pride of creating a work of art and the personal satisfaction of teaching and protecting the reader. Weiss anticipates a future in which technical documentation is generated automatically and the technical documentor's job is merely to feed information databases. In the conclusion, I note a few differences of opinion, but overall I agree with Weiss's view.

Journal

ACM Journal of Computer Documentation (JCD)Association for Computing Machinery

Published: Feb 1, 2002

There are no references for this article.