I don't think you're understanding what he's saying or at least taking
it to the wrong extreme. I'm reading his comment that the docs talk
about how great their API is, not explaining the concepts.
In my last post I said the docs can be too verbose. I *want* the docs
to explain why to me, but they don't have to write a novel. Also I do
not think we have to be 2D graphics API experts having read multiple
2D graphics system books and being experts in there to just understand
how to do basic clipping, although that is what you're suggesting below.
I think your response is one reason so many people who try to provide
feedback on why they find something hard in Cocoa or hard with the
docs get discouraged. You're email to Peter is condescending and
arrogant. You're the super Cocoa dev who's been around since NeXT and
so we must be ignorant or wrong.
Just take the feedback and know that not everyone learns or works the
way you do. The fact that XCode 3 has improved the docs, has improved
the docs UI, and so on shows that feedback helps.
(*) And that's another thing...nowhere else have
I seen documentation that wastes so much time
explaining why _their_ API and paradigm is superior.
Why all the proselytizing? Just tell me how to get
the damn job done! I get it...Apple thinks that
there's no better way to write software than using
Cocoa. Stop hitting me over the head about it!
Great! We have other posters complaining that the documentation
doesn't explain "why" often enough. I am glad you were able to figure
out a 2D graphics system that is identical to PDF and has existed in
Postscript and text books for 30+ years. I am not sure Cocoa
documentation is the best place to learn about general 2D graphics,
winding rules, bezier paths, graphics contexts, etc. I think you
might find interesting similarities in WPF too.
Alex Kac - President and Founder
Web Information Solutions, Inc. - Central Texas Microsoft Certified
Partner
"The optimist proclaims that we live in the best of all possible
worlds; and the pessimist fears this is true."
-- James Clabell
_______________________________________________
Cocoa-dev mailing list (Cocoa-dev@lists.apple.com)
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:
http://lists.apple.com/mailman/options/cocoa-dev/archive%40mail-archive.com
This email sent to [EMAIL PROTECTED]
