apache / apache/maven-site

[MNGSITE-271] CLONE - Better documentation related to repository order

Open
#875 2 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

**[Jakub Bochenski](https://issues.apache.org/jira/secure/ViewProfile.jspa?name=jbochenski)** opened **[MNGSITE-271](https://issues.apache.org/jira/browse/MNGSITE-271?redirect=false)** and commented

I was not able to find clear documentation describing the order of repositories used during a build. For example, the documentation should answer the following questions.
1. Which repositories are used first, the ones defined in settings.xml or in the pom.xml or super pom?
2. The order of repositories defined in the settings.xml profiles seems to be the reverse of what one would expect when viewed in the effective-pom, why is this?
3. If a repository ID in settings.xml matches one defined in pom.xml which one takes priority?

Some additional information is available in the JBoss build forum.
http://community.jboss.org/thread/160185

---

**Issue Links:**
- [MNGSITE-124](https://issues.apache.org/jira/browse/MNGSITE-124) Better documentation related to repository order
(_**"is a clone of"**_)

1 votes, 2 watchers

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by locating the repository documentation covering settings.xml, pom.xml, and the super POM, then compare their repository order with the effective POM. Use the linked JBoss build forum discussion for context. Done means the documentation clearly explains precedence, ordering, and behavior when repository IDs match.

Written by the indexing model from the issue text.

Assessment

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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.