[moderator] Re: Documentation
[moderator] Re: Documentation
- Subject: [moderator] Re: Documentation
- From: Scott Anguish <email@hidden>
- Date: Mon, 4 Aug 2008 14:17:28 -0400
On 4-Aug-08, at 9:00 AM, Allison Newman wrote:
On Monday, August 04, 2008, at 02:42PM, "I. Savant" <email@hidden
> wrote:
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.
During the discussion there were numerous people that felt that the
documentation was just fine the way it was, and they wanted explicit
examples of where the documentation failed. At the time I couldn't
remember any specific examples, but I know that I quite often feel
frustrated by the documentation. So I decided that the next time I
had a good example, I would post it to the list, along with a
request for how other people use the documentation to figure out the
answer for themselves.
This is useful, however as I.S. said, this isn't the place where such
feedback will be effectively noticed and acted upon.
Frankly, I think asking other Cocoa programmers about how to use the
Cocoa documentation effectively, using a specific example to examine
the question, is a perfectly legitimate use of the Cocoa Developer's
list - I certainly don't appreciate you appointing yourself high
judge of what is and isn't appropriate.
I don't read him having done that. He did point out the various
options to provide the feedback in a form that it could be acted upon.
_______________________________________________
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