In the short term, I believe placing the docs along with the distro would be more user-friendly, especially because distribution size is not a big problem right now.
In the long term, separating the two is "cleaner" a. la. JDK. What was the reasoning to do this for Axis2? Mukund Balasubramanian -----Original Message----- From: Eran Chinthaka [mailto:[EMAIL PROTECTED] Sent: Wednesday, January 11, 2006 5:04 PM To: [email protected] Subject: Re: Handling javadoc Copied from new Axis2 distribution plan ? ;-) Saminda Abeyruwan wrote: >Hi Devs, > >In root level of the project, we can see two folders "xdocs" and "docs". >"xdocs" contains all the documentation of Synapse, ex: userguide.html, etc. >"docs" contains all Java documents related to the project. Content in >"docs" is pretty much obsolete now. We need to remove it from the root >level. > >The best way to generate java doc is on the fly. Using a goal in maven >"javadoc" we can easily generate java docs and lets have different >distributions for documents as well. > >We already have Binary distribution and Source distribution in place. Lets >have a another distribution as "document distribution" which only contain >Synapse and java documents. Binary/Source distribution doesn't contain any >documentation. > >This seems pretty clean and clear. > >What would be you thought on prior. > >Saminda > > > --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
