May I make a plea for the ASF POM to include a link to the documentation in the comments?
Also, maybe someone can fix the very long comment line starting with: "As of Version 6, " The description could be wrapped as well. On 27 June 2011 21:42, Benson Margulies <bimargul...@gmail.com> wrote: > It occurs to me that the main pom could include a profile to run the > site pom via the invoker. > > On Mon, Jun 27, 2011 at 4:36 PM, Hervé BOUTEMY <herve.bout...@free.fr> wrote: >> option 1 seems to be controversial >> >> option 2, with site-pom.xml as suggested by Jörg, with specific siteDirectory >> site plugin configuration (to avoid site.xml problem like pom.xml), seems >> pretty good >> >> option 3, [1], doesn't seem accessible in the short term >> >> any objection to go with option 2? >> >> Regards, >> >> Hervé >> >> >> [1] http://mail-archives.apache.org/mod_mbox/maven- >> dev/201106.mbox/%3CBANLkTim7idTDmg=_kx3h1bsmdnqbxk4...@mail.gmail.com%3E >> >> Le lundi 27 juin 2011, Benson Margulies a écrit : >>> Option 1: go ahead and put a full configuration in this POM, and then >>> make sure that all of the things that use it really do over-ride it. >>> >>> Option 2: Give it a parent or child: create a project with a site just >>> to document and aggregate this, with enough SEO to catch googles. >>> >>> Option 3: take up my elaborate suggestion in the mixin thread. >>> >>> On Sun, Jun 26, 2011 at 4:02 AM, Hervé BOUTEMY <herve.bout...@free.fr> >> wrote: >>> >> Now the question is: where do we put ASF pom documentation? >>> > >>> > sharing a few thoughts: >>> > 1. in the project itself? need to find a way to get its publication done >>> > without tainting the pom >>> > >>> > 2. in the Maven site [1], in a dedicated directory >>> > >>> > 3. at the top of pom svn [2]: the main difference I see from Maven site >>> > is that we can configure project information specifically (issue >>> > tracking especially), create dedicated menu >>> > >>> > any thought? >>> > >>> > Regards, >>> > >>> > Hervé >>> > >>> > [1] http://svn.apache.org/viewvc/maven/site/trunk/ >>> > >>> > [2] http://svn.apache.org/viewvc/maven/pom/trunk/ >>> > >>> > --------------------------------------------------------------------- >>> > To unsubscribe, e-mail: dev-unsubscr...@maven.apache.org >>> > For additional commands, e-mail: dev-h...@maven.apache.org >>> >>> --------------------------------------------------------------------- >>> To unsubscribe, e-mail: dev-unsubscr...@maven.apache.org >>> For additional commands, e-mail: dev-h...@maven.apache.org >> >> >> --------------------------------------------------------------------- >> To unsubscribe, e-mail: dev-unsubscr...@maven.apache.org >> For additional commands, e-mail: dev-h...@maven.apache.org >> >> > > --------------------------------------------------------------------- > To unsubscribe, e-mail: dev-unsubscr...@maven.apache.org > For additional commands, e-mail: dev-h...@maven.apache.org > > --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@maven.apache.org For additional commands, e-mail: dev-h...@maven.apache.org
