apache / apache/maven-site-plugin

[MSITE-726] Document how report sets are selected

Open
#820 1 comment 0 reactions 0 assignees View on GitHub
enhancement priority:minor
Dominant language
Java
Stars
55
Forks
50
Avg merge
2d 7h
Merged PRs (30d)
11

Description

**[Oliver B. Fischer](https://issues.apache.org/jira/secure/ViewProfile.jspa?name=o.b.fischer)** opened **[MSITE-726](https://issues.apache.org/jira/browse/MSITE-726?redirect=false)** and commented

Set section [Configuring Reports](http://maven.apache.org/plugins/maven-site-plugin/examples/configuring-reports.html) of the Maven Site plugin describes how to configure multiple report sets.

After reading this section, I got the impression that I can define as many report sets as I would like to have. But the `aggregate` report set seems to be chosen for packing type `pom`.

Hence it would be very helpfull to have very simple and clear explanation how many reports are possible and which report set is chosen under which condition.

---

**Affects:** 3.4

Contributor guide

No contributing guide indexed for this repository

Research direction

Start with the Maven Site plugin's Configuring Reports section, especially its description of multiple report sets and the aggregate report set for pom packaging. Document how many report sets are supported and which set is selected under each condition, with wording that resolves the reported ambiguity.

Written by the indexing model from the issue text.

Assessment

Tech stack
java
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.