Re: Getting Started With WO site
Re: Getting Started With WO site
- Subject: Re: Getting Started With WO site
- From: Mike Schrag <email@hidden>
- Date: Mon, 18 Jun 2007 18:50:11 -0400
Yeah it seemed like it would be nicer going in, but once the content
was in there it has been less than useful ... The one big benefit of
it is that it's not going away any time soon, which can't necessarily
be said of any place that might host a confluence for us.
ms
On Jun 18, 2007, at 6:45 PM, Chuck Hill wrote:
I also am less than thrilled with the WikiBook:
- the process of adding images is painful
- I am not sure if anything else can be added
- searching just the WO content is either not possible or not clear
- the markup is limited
- no one has control over the backups etc.
I have used Confluence quite a bit and find that to be much better
for documenting technical material.
Chuck
On Jun 14, 2007, at 9:22 AM, Steven Mark McCraw wrote:
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:
40global-village.net
This email sent to email@hidden
--
Practical WebObjects - for developers who want to increase their
overall knowledge of WebObjects or who are trying to solve specific
problems.
http://www.global-village.net/products/practical_webobjects
_______________________________________________
Do not post admin requests to the list. They will be ignored.
Webobjects-dev mailing list (email@hidden)
Help/Unsubscribe/Update your Subscription:
40mdimension.com
This email sent to email@hidden
_______________________________________________
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