Noel J. Bergman wrote:
I think we should move everything "up" inside /james/ so we have james/www/, james/server/, james/mailet/With one CVS module? We already have www/, and could reorganize src/conf and src/java into server/ and mailet/ structures. But that leaves us with some issues. First, as I mentioned earlier, one of my issues is I'd like to get the web site out of the same area as the code. Second, I'd like to be able to give commit rights to someone like a Nicola Ken to work on the web site without the code. Not that I think he'd doing anything wrong in the code,
>;->
I have been thinking about this, and it kinda makes sense, but I'm not *that* sure.but from an indemnification perspective, one shouldn't have access to more than one needs. Related to that last point, there may be people to whom we would like to give rights to the Mailet structure; someone who is working on another server supporting the Mailet API, and common mailets. Right now, that requires separate modules. One Community, one PMC, but several sub-projects.
Concrete example: Cocoon has a documentation team with its own mailing list. Docers have access to cocoon-dev. Commit problems? nope.
Docers, devs, apiers, all are part of the same CVS.
The upside: more feel of being part of the same community, more possibility of getting actively involved in the rest of the code in the future.
So it would seem to me that docs and code should reside in the same repo. Overmore javadocs are part of the docs too, and in Cocoon we are going to use them as in Ant to make automatic docs...
Code and Documentation IMV are very closely related.
http://krysalis.org/cgi-bin/krywiki.pl?CoPDoC
Which is also the reason why jakarta-site never took off. It's docs far from the code.
As for the mailet, the thing is a bit different. You have explained that you *want* the community to be possibly indipendent. Mailet would have its own set of docs too, so the mailet docs would go there too.
Take these as ramblings, based on some thoughts springing from recent experiences.
--
Nicola Ken Barozzi [EMAIL PROTECTED]
- verba volant, scripta manent -
(discussions get forgotten, just code remains)
---------------------------------------------------------------------
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
