The Art of Technical Documentation - 1st Edition - ISBN: 9781483184012

The Art of Technical Documentation

1st Edition

Authors: Katherine Haramundanis
eBook ISBN: 9781483184012
Imprint: Digital Press
Published Date: 16th May 2014
Page Count: 286
Sales tax will be calculated at check-out Price includes VAT/GST
30% off
30% off
30% off
20% off
30% off
30% off
20% off
30% off
30% off
30% off
20% off
30% off
30% off
20% off
30% off
30% off
30% off
20% off
30% off
30% off
20% off
72.95
51.06
51.06
51.06
58.36
51.06
51.06
58.36
43.99
30.79
30.79
30.79
35.19
30.79
30.79
35.19
54.95
38.47
38.47
38.47
43.96
38.47
38.47
43.96
Unavailable
Price includes VAT/GST

Institutional Subscription

Secure Checkout

Personal information is secured with SSL technology.

Free Shipping

Free global shipping
No minimum order.

Description

The Art of Technical Documentation presents concepts, techniques, and practices in order to produce effective technical documentation. The book provides the definition of technical documentation; qualities of a good technical documentation; career paths and documentation management styles; precepts of technical documentation; practices for gathering information, understanding what you have gathered, and methods for testing documentation; and considerations of information representation, to provide insights on how different representations affect reader perception of your documents. Technical writers and scientists will find the book a good reference material.

Table of Contents


Contents

About this Book

1 Technical Documentation Defined

Types of Technical Documents

Quality in Technical Documentation

Accuracy

Completeness

Usability

Clarity

Readability

Logical Progression

Conciseness

Appropriateness of Language

Grammaticality

Appropriateness of Content and Scope

Appeal of Package

Further Reading

2 A Career in Technical Documentation

Example of a Project Team

Writing Tasks

Career Growth in Technical Documentation

Documentation Management

The Singleton Operation

The Separate Writing Group

Part of Engineering

The Outside Documentation Consultant

Further Reading

3 Precepts of Technical Documentation

Work Methodology

Know Your Subject

Technical Concepts

Use of Technical Experts

Know Your Reader

Writing for the Novice

Writing for the Experienced User

Writing for the Computer Operator

Writing for the System Manager/Administrator

Writing for the Information Systems Manager

Writing for the Programmer

Writing for Other Industries

Writing Technical Reports and Marketing Literature

Your Technical Training

Know the Rules

Organization of Material

Format Considerations

Categories of Technical Documents

Organizational Elements of Technical Documents

Terminology

Style

Know Your Tools

Further Reading

4 Development Techniques

A Typical Writer's Workplan

Sample Writer's Workplan

The Quality Documentation Process

Research

Understanding

Planning

Writing Your Documentation

Reworking Your Documentation

Receiving the Results

Further Reading

5 Graphics in Technical Documentation

How to Prepare Graphics

How to Use Graphics

How Not to Use Graphics

How to Place Graphics on Your Page

Visualization

Further Reading

6 Information Presentation

The Great Attractors of Technical Documentation

Page Layout

Page Details

Reader-Level Formats

Readability

Punctuation in Technical Documentation

Special Notation

Tables

Book Design

Typography

Printing

Types of Paper

Bindings

Screen Layout

Combined Media

Information Retrieval

Hypertext Systems

Human-Computer Interfaces

Alternative Media

Further Reading

7 Tools

Text Editors

EDT

EMACS

TeachText

LSE/TPU

Graphics Editors

DECwrite

Adobe Illustrator

Micrografx Designer

Support for Information Structures

Text Formatting Software

DSR/troff/dtroff/nroff/RUNOFF

Scribe

Tex

Page Layout Systems

Vax Document

Interactive Page Layout Systems

Interleaf

PageMaker

Language Tools

Electronic Dictionaries

Spelling Checkers

Grammar Checkers

Translation Aids

Language Analysis Tools

Software System Tools

System Features

Code Management Systems

Specialized Authoring Tools

Further Reading

8 Computer Hardware

System Hardware

Personal Computers

Workstation Systems

Minicomputers

Mainframe Computers

Feature Comparison of System Hardware

Input Devices

Keyboards and Mice

Imaging Systems

Scanning Devices

Output Devices

Printers

Video Screens

Hardware Used to Create Your Book

Further Reading

9 Conclusion

A Societies, Conferences, and Journals

Societies

Conferences

Journals and Magazines

B Standards

C Timeline of the Development of Writing

Glossary

Select Bibliography

Index


Details

No. of pages:
286
Language:
English
Copyright:
© Digital Press 1992
Published:
Imprint:
Digital Press
eBook ISBN:
9781483184012

About the Author

Katherine Haramundanis

Affiliations and Expertise

Compaq

Ratings and Reviews
https://www.elsevier.com/books/the-art-of-technical-documentation/haramundanis/978-1-4831-8401-2
www.elsevier.com
crawl=CC-MAIN-2018-30
184642
application/http; msgtype=response
sha1:NCR6M5KIHYD4I6D4RX75C6N6XWPIH2UL
<urn:uuid:2f31921b-2095-470f-8ec0-4de3d7aef1cc>
2018-07-23T00:33:29Z
203.82.26.7
text/html
sha1:6WGLK2RJVSLIQMY3IN6NYBVNOEAHR6NG
<urn:uuid:fa1ab661-3449-4bde-973a-929b774fff0b>
https://www.elsevier.com/books/the-art-of-technical-documentation/haramundanis/978-1-4831-8401-2
response
<urn:uuid:3dff2203-1268-4173-9986-cecf0ce6e1c3>
robots: classic
hostname: ip-10-141-37-174.ec2.internal
software: Nutch 1.6 (CC)
isPartOf: CC-MAIN-2018-30
operator: Common Crawl Admin
description: Wide crawl of the web for July 2018
publisher: Common Crawl
format: WARC File Format 1.0
conformsTo: http://bibnum.bnf.fr/WARC/WARC_ISO_28500_version1_latestdraft.pdf