|
![](/i/fill.gif) |
Orchid XP v8 wrote:
>>> Unfortunately, most people don't seem to realize that a *library* with
>>> no documentation is worse than useless.
>>
>> Yeah, that's very *very* true.
>
> It could be worse; it could have *incorrect* documentation. (!!)
Not really. Usually there's two kinds of incorrect documentation:
1) Documentation that has bugs in it, which is no worse than a library that
has bugs in it.
2) Documentation for the wrong product shipped. Which is pretty much
equivalent to "no documentation" when you discover that's what happened.
Annoying to spend a couple of days trying to figure out how to get something
to work as documented, finally ask on the newsgroups, and be told "We never
documented that. We just shipped the 1.x docs with the 2.x product." Woulda
been nice to know!
--
Darren New, San Diego CA, USA (PST)
Ada - the programming language trying to avoid
you literally shooting yourself in the foot.
Post a reply to this message
|
![](/i/fill.gif) |