Antollini, Mario wrote:
Jean-Sebastien and I would like to add a single slide we can show at
JavaOne where we can share our experience (or BKMs) of working in an
Open Source project.
This is what I have so far...
1. Managing the code
a. Organize the project in small modules
b. Build and manage dependencies with Maven
c. Bug/Issue tracking system: JIRA
d. SVN
2. Discussions held through the mailing list
a. Politeness is key
3. Anyone can contribute
4. Documentation is very important
Hi Mario,
I am interested in what you have to say for bullet "4. Documentation is
very important." After recently joining the Geronimo team, our group had
a lot experience working on the Geronimo docs for 2.1. It took a very
large effort to validate all the docs and the samples were still working
from 2.0 and earlier docs. We worked on ensuring all samples were
versioned in svn, but we had many discussions on how to keep the docs in
step with the samples and the release. It would be nice if there were
some automated ways to mark, version, and update the docs to ensure the
users are getting the best service.
--
Thanks, Dan Becker
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
