Re: Getting Started With WO site
Re: Getting Started With WO site
- Subject: Re: Getting Started With WO site
- From: Steven Mark McCraw <email@hidden>
- Date: Thu, 14 Jun 2007 12:22:03 -0400
Agreed. How do we (and I guess by we I mean everybody on this list)
come to an agreement on the one place that should be the definitive
posting grounds? Honestly, I sometimes find navigating the wiki book
less than ideal, but it's kind of a minor irritation that I can live
with if it solves the problem of a central repository, and there's so
much there already that it seems like the most logical place to me.
Whatever it is, it should be publicly editable, I think, and it has
to be searchable and individual articles must be linkable. Is
anybody in disagreement that the wiki book is the best place ongoing
to post information? If so, can we start an effort to shuttle
information posted elsewhere into the wiki book if it is missing? If
not, what are alternative suggestions for the central repository of
information?
Thanks,
Mark
On Jun 14, 2007, at 12:10 PM, Dana Kashubeck wrote:
On 6/14/07 11:57 AM, Steven Mark McCraw wrote:
My understanding is that the webobjects wiki book (http://
en.wikibooks.org/wiki/Programming:WebObjects) is trying to become
the central point of documentation for WebObjects that people post
to. There's already a ton of info there, but we all know it could
use a ton more. At WOWODC, when the experts panel was asked what
could be done to help with project wonder, this is what they came
back with immediately: We need people writing documentation, and
this is the place to put it. Even if it's bad, there are so many
people watching it that bad info will get edited out quickly.
I think there's a danger in having TOO many informational sites.
If everybody decides to wing it because they get on a high at a
developer's conference regarding being able to document stuff to
widen the movement, I think we will end up with dozens of blogs,
half finished tutorials, etc. There's a reason there isn't much
documentation on Wonder and WebObjects: writing good
documentation is HARD and time consuming, and not a very glamorous
task. So if you have 10 spare hours to write a decent article on
a very specific issue, I think everybody would be better served if
that went to the wikibook. That way, everybody can always point
to one resource as definitive.
I don't mean to be preachy about it or rain on anybody's parade
that is putting up yet another site about WebObjects. What I just
wrote might sound snappy or mean, but I don't mean it that way.
I'm just trying to advocate a central repository for everything so
people don't have to go here and there to get various pieces of
the overall puzzle. Maybe if you start a site, you could also
make sure that all of the contents of that site are also posted in
the wiki book in the sensible place? Thoughts?
I was thinking the same thing. Last year there were some really
great efforts to put together "the site" for WebObjects
information. I think it was this one: http://wiki.objectstyle.org/
confluence/display/WOCOM/WOCOM
So there's that wiki, the wiki book, www.wocommunity.org, etc.,
etc. I completely agree that there is a huge need for
documentation and resources and it is important for the community
to put these things together. But right now everything just seems
*so* scattered! Can those who have been generous enough with their
time please post their content on one of the already existing sites?
--
-------------------------------------
Dana Kashubeck
Systems Manager
Riemer Reporting Service Inc.
http://www.riemer.com
Phone: 440-835-2477 x. 125
Fax: 440-835-4594
-------------------------------------
<dana.kashubeck.vcf>
_______________________________________________
Do not post admin requests to the list. They will be ignored.
Webobjects-dev mailing list (email@hidden)
Help/Unsubscribe/Update your Subscription:
This email sent to email@hidden