Hi,
I've been playing a bit trying to generate the maven
site, which was reported as non buildable, and non
fixable too.

In fact, at the moment, the generation fails solid, or to be
more precise, enters an infinite loop.

I tracked that down to an interaction between
javadoc aggregation and the site plugin, it is
sufficient to upgrade the two plugins, turn off
javadoc aggregation and the site generation
works. Which is not that bad, since recent javadoc
plugin version have a separate goal, javadoc:aggreate,
to perform javadoc aggregation anyways.

The resulting site has however broken links between
parent and child modules. This one was due to
the <url> tags located in each module, that forced
the child links to the wrong url. After that is
removed, the site generated with a deploy is fully
linked (one generated with just "mvn site" never is,
and that is aknowledged by the maven site guide).

Even reaching this point, the generated site has
customizations that point to geotools.fr, those
can be killed by removing the site.xml present
in most modules src/site directory.

Finally, even with that, the report generated
is not very interesting. I've tried to cut
down the repetitions (do you want the ml to
be mentioned in each module?) and add some interesting
reports, such as cobertura code coverage
and findbugs.

I still haven't tried to make a full build,
since those reports take _a long time_ to
generate, but I've made the site for the
library module (this alone took 13 minutes and
uses 267MB of space, uncompressed, roughly half
in cobertura reports and half in javadoc/jxr
ones) and I've made it available for you to look at
here:
http://atlas.openplans.org/~aaime/gtsite/index.html

Would it be nice to have this report being
built daily? I guess so.
Yet, building for the whole project
might take 1-2 hours I fear, not sure
we have enough free cycles on the
build server to understake this.
I was thinking that once a week could
be good enough (but I don't have any
confirmation from OpenGeo in this direction
either).

Anyways, what do you think? The site per-se
is as ugly as it gets, but the reports
seem valuable to me.

Cheers
Andrea


-- 
Andrea Aime
OpenGeo - http://opengeo.org
Expert service straight from the developers.

------------------------------------------------------------------------------
Register Now for Creativity and Technology (CaT), June 3rd, NYC. CaT
is a gathering of tech-side developers & brand creativity professionals. Meet
the minds behind Google Creative Lab, Visual Complexity, Processing, & 
iPhoneDevCamp asthey present alongside digital heavyweights like Barbarian
Group, R/GA, & Big Spaceship. http://www.creativitycat.com 
_______________________________________________
Geotools-devel mailing list
Geotools-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geotools-devel

Reply via email to