On Wed, 17 Mar 1999, Cliff Tuel wrote:
> The WebObjects Programming Topics, in addition to shipping with WOF
> 4.0.1, are online at
>
>http://developer.apple.com/techpubs/webobjects/System/Documentation/Developer/WebObjects/Topics/TopicsTOC.html
As others have mentioned, this looks like a great start. I sent some more
comments to people who are apparently outside of Apple
documentation-group-loop, so I *hope* that somebody hears and heeds the
following comments.
Again, this is intended to be constructive criticism:
1) I had a bear of a time figuring out how to pass arguments to
components I'd written in a .wod file. I now know that the syntax is what
you'd expect, but trying to find verification of this in the WO Dev Guide
was really irritating. (Finally found it on page 50) I think the dev guide
is not nearly clear enough at distinguishing between Dynamic elements and
Reusable components, two very seperate things which are referenced in an
identical fashion in the .wod file.
2) pg 50 of the Dev Guide under Declaration File Syntax implies "nobody
ever looks at .wod files so this is only for the curious..". Why? I just
upgraded from WO3.1 where WOBuilder was useless, so I *mostly* edit the
components by hand. It'd be so easy to explain things from the
textfile-perspective too, in addition to the GUI perspective. Some people
still like emacs and vi, ya know. :-)
3) The docs need to gently coach users that ask "the wrong question"
because they don't have the proper OO-perspective. eg people who ask
"how the hell do a SELECT DISTINCT CATEGORY FROM MOVIES ORDER BY ASCENDING
in the Movies example?" Please pay special attention to newbies with a
strong relational background 'cause I think most of your converts are
current webweavers who started with Perl & Msql (or similarly crappy
tools) and are just getting their first good taste of clean OO in
WebObjects.
I think all you'd need to do is get 100 new developers and just sit with
them for a few weeks as they try to figure things out on their own,
recording their questions...
Good luck all. Thanks once more to the gurus to keep helping us newcomers
time and time again (you know who you are).
--
\7\3\d\e\k\b\8\u\o\x\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \
\m\a\t\t\.\k\a\n\g\a\s\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \
m\a\t\t\@\k\a\n\g\a\s\.\o\r\g\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \
