jackrabbit-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Fabrizio Giustina" <fgi...@apache.org>
Subject Re: move site outside of maven?
Date Wed, 15 Mar 2006 21:53:50 GMT
Hi Roy
maybe I can help undestanding if there are real issues with Maven,
before thinking about swithing to Anakia... some of the things
mentioned here sound pretty new to me

On 3/15/06, Roy T. Fielding <fielding@gbiv.com> wrote:
> I am increasingly finding that 95% or more of the maven generated
> information is too detailed and changes too often to be useful for
> a real site. In particular, the generators randomly change anchor
> names for no good reason, which makes oversight of documentation
> impossible.

This should not happen, where are you seeing this behavior?

> I also find the content of the maven generated info,
> such as the list of project devs, to be mostly useless and not
> very configurable.

what would you actually like to configure for the dev list that you
couldn't do? It just lists devs and contributors from the project pom,
so apart from this list there is no additional customization needed.
Keep in mind that for each report that you don't like you can simply
exclude it or just replace it with a totally custom xdoc.

> I am thinking of switching to plain Anakia for the site and using
> hand-crafted XML pages for project information.

well, as just said you can already do that using maven, if needed.

I also don't think that all the maven reports are useless... I find
pretty useful to find test reports, xrefs, change logs published, and
there are plenty of other reports/plugins that jackrabbit doesn't use
at the moment that could be added in future and bring more value to
the documentation or help developers (e.g. coverage report, checkstyle

my 2c


View raw message