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 Laboratory (LANL), Los Alamos, NM (United States)
- DOE Contract Number:
- W-7405-ENG-36
- OSTI ID:
- 5640557
- Report Number(s):
- LA-UR-85-1804; CONF-8506133-1; ON: DE85012737
- Resource Relation:
- Conference: 4. international conference on systems documentation, Ithaca, NY, USA, 20 Jun 1985
- Country of Publication:
- United States
- Language:
- English
Similar Records
Style guide for oil and gas professionals
Procedure Parsing: A Method for Parsing Handwritten Documents into Computer-Based Procedures