On Jan 3, 2007, at 3:37 AM, Mark Brouwer wrote:
What is the policy at Apache for hosting the generated javadoc for
what
we call specifications and implementations, as is currently done by
Sun
at e.g. http://java.sun.com/products/jini/2.1/doc/api/
All projects I checked (which was just a sample) have no online
Javadoc
and from the past I can recall some deferred to other parties for
hosting the Javadoc.
In my experience, we put the Javadoc right on the website. Now, this
is stuff I didn't check in, but just generated and "hung" on the
website at a designated spot.
But it's the javadoc generated from the project source, not the spec
javadoc from elsewhere.
My personal opinion is that I would like to have the Javadoc online
for
the main branch (I believe you call it the trunk) that reflect the
nightly builds as well for every latest release, all in a
predictable place.
Not only is this convenient to point to in discussions and helping out
people, it is also essential for those that like to link against these
when generating their own Javadoc.
Ok. I think the nightly is excessive, but I don't really care either
way :)
BTW for the Sun people, what will happen with the current hosting of
specifications, etc. at http://java.sun.com/products/jini?
--
Mark
