While I tend to lean toward the 'use OSS when possible' side,
Confluence is a sexy wiki.
If we can get a confluence instance, how feasible would it be to:
- move all the documentation to the wiki
- have that content available as a PDF to replace what we moved
We could even go so far as to commit the pdf to svn so we can version
it along with the distributions.
I see this as having several positive aspects.
- we no longer have to publish the site documentation on every
simple change
- we can use that cool snippet plugin
- those who prefer to grab a zip/pdf and run can do so (without
having to build from src xdocs if offline)
- there are more I'm sure....
--
James Mitchell
678.910.8017
On Aug 8, 2006, at 8:00 PM, Wendy Smoak wrote:
On 8/8/06, Sean Schofield <[EMAIL PROTECTED]> wrote:
What do people think about setting up a confluence wiki for Shale?
Wendy tipped me off about cwiki.apache.org. Apparently its up and
running now. Personally I think Confluence is a lot better then the
current wiki.
I wanted it from the beginning, but they were still working out the
details. It seems to be available now, requests for new spaces and
imports are being fulfilled.
Take a look at how Geronimo is using it: http://cwiki.apache.org/
geronimo/
They have a separate 'space' for the docs for each version, one for
development, project management, knowledge base, and sandbox.
The space naming convention would probably give us SHLx___
Do we want to have just one space, and use it like we use Moin, or do
we want to push most of the project docs to the wiki?
In the second case we might want SHLxDEV for our notes on how to use
Maven and Subversion for various things, and another one for docs that
get exported and included in the distribution.
--
Wendy
