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

Claude Warren commented on MSITE-1016:
--------------------------------------

Ok, so the documentation is wrong and you have to have a valid URL for the 
stage to work?  Except you don't.

Or, The documentation is correct and you don't need to specify the URL.  Except 
that it doesn't have to be a valid URL.

In my opinion, the site:stage goal should work without the URL being specified, 
or perhaps with the url empty (e.g. "<url></url>").  I suspect that without the 
URL "deploy" deploys to the "target/staging" directory as noted in the 
documentation.   The problem arises in that the documentation says if the URL 
is not specified it will write to "target/staging" and that is exactly what it 
does if the URL is invalid.  But the pom check seems to require the URL so an 
invalid one allows the "target/staging" to be written to.  

It feels like the check for the URL needs to be relaxed.  Perhaps not for all 
targets, but for "stage" and from [~michael-o] 's comment "deploy"



> site:stage should function without a URL specified in the POM
> -------------------------------------------------------------
>
>                 Key: MSITE-1016
>                 URL: https://issues.apache.org/jira/browse/MSITE-1016
>             Project: Maven Site Plugin
>          Issue Type: Improvement
>          Components: Maven 3
>    Affects Versions: 3.20.0
>            Reporter: Claude Warren
>            Priority: Major
>             Fix For: waiting-for-feedback
>
>
> Note: actual version is 3.8.6
> *Documentation states:*
> {quote}By default, the site will be staged in a directory 
> {{{}target/staging/{}}}.
> {quote}
> *Issue description:*
> When I try to run site:stage without a site entry in the pom 
> distrobutionManagement section I get an error that says the site entry must 
> be specified.
> {quote}Specifying 
> <distributionManagement>
> <site>
> <id>staging</id>
> </site>
> </distributionManagement>
> {quote}
> Will yield an error that states the URL must be specified. Entering an 
> invalid URL solves the problem.
> {quote}<distributionManagement>
> <site>
> <id>staging</id>
> <url>invalid:url</url>
> </site>
> </distributionManagement>
> {quote}
> The above is literally the text in my pom file.
> *Desired setup:*
> I would like to see the URL be optional so that I can trigger the site:stage 
> goal without having to specify the URL in the pom and without having to 
> specify the stagingDirectory on the command line.
> I would also like this better documented.



--
This message was sent by Atlassian Jira
(v8.20.10#820010)

Reply via email to