Re: Documentation frustrations
Re: Documentation frustrations
- Subject: Re: Documentation frustrations
- From: Piers Uso Walter <email@hidden>
- Date: Sun, 10 Jul 2005 00:40:05 +0200
On 9. Jul 2005, at 08:25, Raffael Cavallaro wrote:
I agree that the docs seem to have been written with this attitude.
But this attitude - that there is a critical mass one needs to know
before the docs become useful - more or less defeats the purpose of
documentation. Documentation should be geared toward those who
don't know what the docs contain. After all, if you already know
what they say, you wouldn't be consulting them.
Are you serious? What you call an attitude seems to me to be the most
basic fact about any kind of documentation. I totally fail to see the
contradiction that you seem to notice.
Just knowing the things that are necessary to understand the
documentation does not mean that one knows everything in the docs or
that it wouldn't be easier to look up stuff than to try to remember it.
Perhaps this becomes more clear if you rephrase your sentence to read
"there is a critical mass one needs to understand before the docs
become useful"
With kind regards
Piers
--
Piers Uso Walter <email@hidden>
ilink Kommunikationssysteme GmbH
_______________________________________________
Do not post admin requests to the list. They will be ignored.
Cocoa-dev mailing list (email@hidden)
Help/Unsubscribe/Update your Subscription:
This email sent to email@hidden