TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
>I don't see the contradiction in basing estimates on time per page and
saying
>quality docs are as short as possible.
This idea that "quality docs are a short as possible" has been bandied about
quite a bit in this discussion, but it is really another case of misplaced
metrics. Quality documentation has a mean time to productivity that is as
short as possible. This is not the same thing as being physically as short
as possible.
Sometimes more is less. More instruction may lead to faster comprehension.
Quality has nothing to do with length. Short is not better than long, or
vice versa.
Usable is better than unusable. That is all ye know on earth, and all ye
need to know.
---
Mark Baker
Senior Technical Communicator
OmniMark Technologies Corporation
1400 Blair Place
Gloucester, Ontario
Canada, K1J 9B8
Phone: 613-745-4242
Fax: 613-745-5560
Email mbaker -at- omnimark -dot- com
Web: http://www.omnimark.com
