Re: Documentation frustrations
Re: Documentation frustrations
- Subject: Re: Documentation frustrations
- From: James Andrews <email@hidden>
- Date: Sat, 9 Jul 2005 02:58:00 -0400
As I haven't really gone through them since before tiger's release I
don't have any examples off hand. If I find something that sticks
out as *huh* why's this here, and *what does is that suppose to mean*
I'll speak up, but after going through some of the docs, there seems
to be more example tutorial wise which wasn't the case prior to
tiger. One thing that does stick out, and is in reference to my
setIsVisible comment. I can see why it's documented elsewhere as
it's part of the NSWindowScripting, but things like this should be
somehow referenced in NSWindow as well, as it's being called the same
way as a normal method for that class. It should just be side noted
that it's not really part of that class, but it works the same way.
james
On Jul 9, 2005, at 2:43 AM, mmalcolm crawford wrote:
On Jul 8, 2005, at 11:33 PM, James Andrews wrote:
I can see where there is a lot of information about obj-c, and I
can see where it'd be hard to organize It' not just what is
written, but the way it's organized on the site.
If you have suggestions for organisation that you think would make
things easier, please let me know.
Something I expected would be in one section is instead posted in
another. It's just hard to find things in most cases, and some
pages are utterly useless they have 2 paragraphs of 3-4 sentences
that really don't tell you anything, even in some of the docs for
specific objects, you look at a method, and look at it's
description, and your like "WTF does that mean?". It's just bad.
When you find cases like this, please file bug reports.
mmalc
_______________________________________________
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
_______________________________________________
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