I see. To each their own, of course. I prefer more slimmed down API
references segregated from detailed teaching aids and haven't felt it
difficult to find what I need in the WE docs. But I don't get to choose
what's in the WE docs, so what I think doesn't really matter.
On 8/13/2011 11:06 AM, BT wrote:
Hi Jared,
That is the usual explanation and nothing gets done. There are some
great examples in some of the Object Model tree view, but as you point out,
a person jumps around and around. So, excusing it only prevents one concise
simple reference manual.
As I said a reference manual should show more of what an engineer has
written with a proven example; like the W3 Schools attempts to do, also
using web live examples when possible. I am not saying live examples, but an
example can make things a lot easier; immediate mode does this feature when
you run the example.
Python also does this and it is an open source, free stuff and in almost
all cases you have the huge manual to go through.
When Aaron asked I had mentioned to just give an example in the location
where it says it is a so and so object. I even have to look in some other
text to even find the Treeview and Listview event names, it is not in the
Help Menu App Doc; searching for something you must no how it is spelled
first and guessing maybe you get lucky.
I assumed the Key object is a stand alone like the keyboard object is,
according to the logic of the tree view list and when creating an object it
said none was created...
Inside the Keyboard object it uses the Keys, plural form, and search
around for another place where key was mentioned and decided to quit looking
at that point because there was only the main list one which I already
attempted to use.
But, as I said, as long as people say it is not for the novice, yet
people keep on asking, and keep getting these responses, nothing gets done.
I am not knocking Chip for he is going through one example at a time and
there is documentation of what he is doing, all I am asking for is the final
project, "All In One Location!"
Sincerely
Bruce
Sent: Friday, August 12, 2011 11:45 PM
Subject: Re: Tree view
On 8/12/2011 2:11 PM, BT wrote:
"Granted experienced programmers don't need it, but first time users do."
API references aren't really for first time programmers though, at least
not without something else to guide their exploration. That's where the
Wiki, Chips' audio classes, etc. prove their worth.
