Re: Documentation plan?

Subject: Re: Documentation plan?
From: Alun Whittaker <alun -at- CORTE-MADERA -dot- GEOQUEST -dot- SLB -dot- COM>
Date: Wed, 1 Dec 1993 10:43:50 PST

Everything you said made absolutely perfect sense to me except this.
How can you know how many pages/figures/screens until you are done?


Illustrations can be disproportionately more expensive than text in
terms of time, talent, page count and printing requirements. This
is probably least important for software documentation in which
you may be able to get away with one plane, black and white screen
captures. It becomes critical if you are documenting a large
physical process or installation which may require gray-scale or
color drawings and photographs plus the time and cost of
transporting someone there to get them -- like an offshore oil rig
or a South African diamond mine.

If you are pitching a book to a commercial publisher, they will
use your figure count to estimate production cost and then hold
you to it. Extra or more elaborate illustrations may have to come
out of your royalties or even out of your pocket up front.


Previous by Author: Anyone Interested?
Next by Author: Cocktail Party Conversation
Previous by Thread: Re: Documentation plan?
Next by Thread: Re: Documentation plan?

What this post helpful? Share it with friends and colleagues:

Sponsored Ads