apache / apache/maven-site

Clarify Distribution Management field in POM

Open
#1,440 7 comments 0 reactions 0 assignees View on GitHub
enhancement
Dominant language
Java
Stars
123
Forks
301
Avg merge
16h 59m
Merged PRs (30d)
32

Description

### Improvement proposal

According to https://maven.apache.org/pom.html#Repository

> distributionManagement specifies where (and how) this project will get to a remote repository when it is deployed

However @cstamas rather thinks this should be used to indicate where consumers can download it (https://maveniverse.eu/docs/njord/migration/#setup-your-project).

I know that currently even maven-deploy-plugin interprets it like the former, but the question is whether the documentation should be adjusted to indicate its intention.

Contributor guide

No contributing guide indexed for this repository

Research direction

Read the POM Repository documentation and the linked Njord migration guidance first, then compare the stated meaning with how maven-deploy-plugin interprets distributionManagement. Done means the intended meaning is decided and the relevant documentation wording is updated consistently; the issue does not name a repository file or test.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.