Subject: Re: aix7xxx -- A Suggestion!
To: None <Havard.Eidnes@runit.sintef.no>
From: Todd Whitesel <email@example.com>
Date: 01/03/1999 20:12:11
> If the FreeBSD folks are even kind enough to
> supply us with better documentation for their CAM stuff that should
> make porting and/or adapting older HBA drivers even easier.
Documentation is like software except you mainly use it to train people.
The best way to improve documentation is to attempt to use it, and send
bug reports; and I don't mean corrections.
- good questions mean that the doc has a bug.
- RTFM questions mean that the index has a bug, or at least could be
richer (by using formats other than the traditional keyword/pagenums).
Obviously this glosses over a lot, but at work I've seen a lot of people
(including me!) be repeatedly blind to the difficulty of generating docs
out of thin air for their own work. It really helps to have an unfamiliar
brain make the same journey and flush out the "obvious" things that aren't.
toddpw @ best.com