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: Mon, 18 Jun 2007 19:24:15 -0400
Well, then, should those of us who want a centralized repository
focus on the confluence wiki? I would be happy to volunteer a little
time each day trying to organize the thing and bring content from the
wiki book (and anywhere else I can get info with the author's
permission) over to the confluence site if everybody is in agreement
that this is the smart thing to do.
On Jun 18, 2007, at 6:50 PM, Mike Schrag wrote:
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:
40bluecollarsoftware.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