Improving systems documentation using an online copy editor
For the last three years the author has been using Writers Workbench, a UNIX text-editing tool, to edit computer documentation. In this article the author outlines his experiences using the system, noting both the advantages to explore and pitfalls to avoid in using this tool. Writers Workbench is especially useful for improving a writer's basic skills - punctuation, spelling, and grammar. When used effectively, Writers Workbench can cut down on wordiness and improve the consistency of a manual. It can help in the creation of a table of contents, index, glossary, and bibliography and in checking readability. Furthermore, by creating user-defined dictionaries, authors or editors can customize the tool to fit their purposes and styles. However, Writers Workbench is not good at catching problems relating to organization, focus, and clarity.
- Research Organization:
- Los Alamos National Lab., NM (USA)
- DOE Contract Number:
- W-7405-ENG-36
- OSTI ID:
- 5640557
- Report Number(s):
- LA-UR-85-1804; CONF-8506133-1; ON: DE85012737
- Country of Publication:
- United States
- Language:
- English
Similar Records
Style guide for oil and gas professionals
NRC (Nuclear Regulatory Commission) editorial style guide
Training the unseasoned technical writer-editor: From the trainee's perspective
Book
·
Mon Dec 31 23:00:00 EST 1984
·
OSTI ID:6367366
NRC (Nuclear Regulatory Commission) editorial style guide
Technical Report
·
Sun Oct 01 00:00:00 EDT 1989
·
OSTI ID:5342815
Training the unseasoned technical writer-editor: From the trainee's perspective
Conference
·
Mon Dec 31 23:00:00 EST 1990
·
OSTI ID:5724161