cocoon-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Nicola Ken Barozzi" <nicola...@apache.org>
Subject Re: Wiki documentation system
Date Fri, 07 Jun 2002 20:04:03 GMT
From: "Steven Noels" <stevenn@outerthought.org>

> > From: Brian Topping [mailto:topping@digidemic.com]
>
> > documentation.  But if the documentation process (context
> > diffs contributed as patches to bugzilla) is more difficult
> > than the change itself (maybe a sentence or two in some
> > cases), I am less inclined to make a contribution since I
> > also need to get work done toward my own goals.
>
> Exactly, I don't like the Bugzilla approach for document creation &
> revision neither, but there are no ambitions whatsoever to host other
> fancy dynamic stuff on ASF equipment. The PHP people basically provide
> their own physical equipment, that's why they have lots of dynamic
> stuff, also for documentation. Also, do not underestimate the load these
> sites take when going for a centralized approach.

+1

If someone would offer for free a server *and* bandwidth, we would try this
in no time.
IMO though, the fact that we need to go more slowly and use available
resources is an opportunity.

> Having a cocoon documentation selfhelp webapp running locally, pushing
> new and modified content to some central aggregation point however would
> be really great. Radio Userland comes to mind, and that should sound a
> bell to many of you ;-)

;-)

> Making this a part of Forrest would be even better. Currently, we're
> starting off slowly, doing static builds of decentralized documentation
> using a centralized system. Having a centralized system for distributed
> documentation maintenance would be of tremendous value. So if some of
> you are really serious about this and want to grok their teeth on
> xml.apache-wide stuff instead of Cocoon-only, come and join us!

Yeah! :-D

BTW, are you sure it's best to keep the documents in xml format?
Aren't diffs from CVS stuff more informative if using wiki format?

--
Nicola Ken Barozzi                   nicolaken@apache.org
            - verba volant, scripta manent -
   (discussions get forgotten, just code remains)
---------------------------------------------------------------------


---------------------------------------------------------------------
To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
For additional commands, email: cocoon-dev-help@xml.apache.org


Mime
View raw message