[Commented] (MSITE-688) Enhance site:stage documentation

classic Classic list List threaded Threaded
1 message Options
Reply | Threaded
Open this post in threaded view

[Commented] (MSITE-688) Enhance site:stage documentation

JIRA jira@apache.org

    [ https://issues.apache.org/jira/browse/MSITE-688?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16576827#comment-16576827 ]

Michael Osipov commented on MSITE-688:

[~hboutemy], has this been resolved two years ago?

> Enhance site:stage documentation
> --------------------------------
>                 Key: MSITE-688
>                 URL: https://issues.apache.org/jira/browse/MSITE-688
>             Project: Maven Site Plugin
>          Issue Type: Improvement
>          Components: site:stage(-deploy)
>    Affects Versions: 3.3
>            Reporter: scolebourne2
>            Priority: Minor
> The site:stage goal would benefit from enhanced documentation.
> Firstly, the summary, http://maven.apache.org/plugins/maven-site-plugin/plugin-info.html, is not clear about the need to run "mvn site" before "mvn site:stage". Add the sentence "This goal requires the site to already have been generated using the site goal, such as by calling "mvn site".
> Secondly, there needs to be an expansion of the documentation for multi-module/reactor builds to give examples of the complete set of values needed to make it work http://maven.apache.org/plugins/maven-site-plugin/examples/multimodule.html .
> Since there are multiple different multi-module project layouts (separate aggregator/parent vs same aggregator/parent, aggregator contains parent etc), this is likely to need multiple examples. The examples should focus on the right settings to use for fields such as distribution.site.url (and the fact that distribution.site.id is also mandatory).

This message was sent by Atlassian JIRA