Bertrand Delacretaz wrote: some short notes:
Cocoon "newbie docs" requirements:
1) GOAL: create a source of reliable information for Cocoon newbies, along the lines of "how to setup Cocoon in 15 minutes" and ""HOWTO setup your intranet with XML in 1 day"
like that :-)
2) MUST allow users to comment/improve these docs, in "wiki mode" to make it as easy as possible
OK
3) MUST clearly identify these docs as being "for beginners" and "reviewed by an editor of the Cocoon team" to prevent beginners from getting lost in obsolete/unreliable docsThat might warrant a different Wiki instance for these docs since this breaks the fundamental 'uncategorization-ness' of Wikis... or we would have to hack JSPWiki. A Wiki doesn't know 'sections', or it ain't a true Wiki...
4) SHOULD make these docs and their comments searchable, separately from the technical and/or unchecked existing docs to prevent beginners from being overwhelmed with irrelevant search results.JSPWiki offers a global search (which is a bit broken in the version currently deployed on wiki.cocoondev.org), but I said already that I'll try to fix that ASAP. There's another, invisible issue with the Wiki which I need to fix, but which doesn't prevent normal operations. It only prevents easy upgrades. And nobody like to hack JSPs over here, I assume ;-)
5) MUST allow all wiki docs (these and existing ones) to be searchable simultaneously, to prevent users from having to search in X different places for info.If we really want to be sophisticted, someone might build a webapp with Lucene and have that deployed on search.cocoondev.org, fed with a collection of Cocoon-specific URIs
6) SHOULD be integrated with existing Cocoon community tools to avoid fragmentation of skills and resources (for me it is actually a MUST ;-)Given the success of the existing Wiki, I would seriously recommend against creating a new one, even if it's for a specific purpose.
</Steven>
--
Steven Noels http://outerthought.org/
Outerthought - Open Source, Java & XML Competence Support Center
Read my weblog at http://blogs.cocoondev.org/stevenn/
stevenn at outerthought.org stevenn at apache.org
---------------------------------------------------------------------
Please check that your question has not already been answered in the
FAQ before posting. <http://xml.apache.org/cocoon/faq/index.html>
To unsubscribe, e-mail: <[EMAIL PROTECTED]>
For additional commands, e-mail: <[EMAIL PROTECTED]>
