Re: Documentation
Re: Documentation
- Subject: Re: Documentation
- From: "I. Savant" <email@hidden>
- Date: Mon, 4 Aug 2008 11:38:33 -0400
On Mon, Aug 4, 2008 at 8:42 AM, I. Savant <email@hidden> wrote:
>> More generally on the topic of documentation, this is the typical kind of problem where I find that the documentation fails - when you don't have a clue as to what sort of API might be responsible, the documentation is quite poor for enabling you to discover the API by yourself. Poor discoverabilty...
>
> I think the long on-list discussion(s) you mentioned about the
> documentation kept pointing back to the feedback mechanism. This isn't
> really the place to complain if you expect results. Post feedback,
> contact DTS, et cetera. Posting it on-list really only amounts to
> noise, since everyone has their opinions and it's pretty clear those
> opinions are evenly polarized.
For the record (because I appear to have deeply offended someone),
the request for clarification on where to find an answer to the OP's
other thread wasn't what I had the problem with. Having followed the
previous discussions on the documentation (where some posters became
outright vicious regarding the documentation and its authors), it was
the second comment I quoted above that I took exception to. It boils
down to this:
A - It's been stated numerous times that the list is no place for this
type of feedback (because it won't change anything whatsoever) but the
feedback forms on the bottom of the documentation pages or WWDR are.
B - This type of feedback touches off a "sore spot" that doesn't
benefit much because of point A.
C - There is nothing wrong with citing the rules and general topic
relevance; there are thousands of list members and only two
moderators. Some generalized self-moderation is required. I certainly
didn't threaten with banning or other forms of censure because I am
NOT a moderator.
Also, perhaps the use of the words "complain" and "noise" were what
caused the panty bunching, so for that choice of words I do apologize.
The general spirit of my comment was to keep the list on-topic and
flame-free, a responsibility we all share. Unfortunately some people
*really* don't like to be disagreed with ...
--
I.S.
_______________________________________________
Cocoa-dev mailing list (email@hidden)
Please do not post admin requests or moderator comments to the list.
Contact the moderators at cocoa-dev-admins(at)lists.apple.com
Help/Unsubscribe/Update your Subscription:
This email sent to email@hidden