Hi Harald, you are certainly right that we could need something like this. But right now I don't see the real advantages of it. The javadoc artefacts are published to maven central. So what a dev really needs the proper javadoc while coding is already there.
The thing about uploading this HTML stuff is not as simple as it might look at first glance. First of all we need the server infrastructure for it and time and know how to keep it going, second we probably also need a specialized account for uploading this HTML stuff cause we certainly don't want our server infrastructure (at least what is left) be compromised again. So since we all are pretty much lacking the know-how and time to do proper administration I'm sure it is OK to keep it the way it is right now. Regarding the amount of documentation. Yep you are certainly right that it could / needs improvements. But hey, making it public won't make it better, I'm for sure. Regards, Achim 2011/8/18 Harald Wellmann <[email protected]>: > To my best knowledge, none of the OPS4J projects publish Javadoc on a > regular basis. > > Ok, the Maven Release Plugin pushes Javadoc artifacts to the Sonatype OSS > Repository and from there to Maven Central, but you can't actually browse > the Javadoc pages from there. > > The fact that many Javadoc comments are missing in the sources or are not > very helpful should not be an excuse for not publishing Javadoc. > > On the contrary, I hope a working publishing chain (with inter-project links > properly set up, which is essential for the closely related Pax projects) > would encourage people to write more and better Javadoc and reduce the need > to copy redundant information to the Wiki. > > Any ideas how to set this up? > > There might a connection with the disused Maven Site build, which normally > includes Javadoc generation. Now I do agree we don't really need Maven Site > reports (they were awfully slow last time I tried), but we should take care > not to make Javadoc builds harder by removing any configuration which might > be useful in this context. > > Best regards, > Harald > > _______________________________________________ > general mailing list > [email protected] > http://lists.ops4j.org/mailman/listinfo/general > -- -- *Achim Nierbeck* Apache Karaf <http://karaf.apache.org/> Committer & PMC OPS4J Pax Web <http://wiki.ops4j.org/display/paxweb/Pax+Web/> Committer & Project Lead blog <http://notizblog.nierbeck.de/> _______________________________________________ general mailing list [email protected] http://lists.ops4j.org/mailman/listinfo/general
