apache / apache/maven-site-plugin

[MSITE-1016] site:stage should function without a URL specified in the POM

Open
#1,140 6 comments 0 reactions 0 assignees View on GitHub
enhancement priority:major
Dominant language
Java
Stars
55
Forks
50
Avg merge
2d 7h
Merged PRs (30d)
11

Description

**[Claude Warren](https://issues.apache.org/jira/secure/ViewProfile.jspa?name=claudenw)** opened **[MSITE-1016](https://issues.apache.org/jira/browse/MSITE-1016?redirect=false)** and commented

Note: actual version is 3.8.6

**Documentation states:**

> By default, the site will be staged in a directory `{}target/staging/{`}.

**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.

> Specifying
> \
> \
> \staging\
> \
> \

Will yield an error that states the URL must be specified. Entering an invalid URL solves the problem.

> \
> > > \
> > > \staging\
> > > \invalid:url\
> > > \
> > > \

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.

---

**Affects:** 3.20.0

**Issue Links:**
- [RAT-409](https://issues.apache.org/jira/browse/RAT-409) Site generation does not work without package
(_**"is caused by"**_)

Contributor guide

No contributing guide indexed for this repository

Research direction

Start with the site:stage goal and the POM distributionManagement site configuration described in the issue. Check how stagingDirectory and the site URL are required, then verify the documented default staging behavior. Done means site:stage works without a site URL or command-line stagingDirectory, and the documentation explains the setup.

Written by the indexing model from the issue text.

Assessment

Tech stack
java
Domain
build-system, documentation
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
42/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.