Chealer commented on issue #873: URL: https://github.com/apache/maven-site/issues/873#issuecomment-3666548435
Greetings @Bukama, > Hi [@Chealer](https://github.com/Chealer) I was pondering some time about your issue and the only clear thing I saw was the missing note about `<properties>` (see [#1490](https://github.com/apache/maven-site/pull/1490) ). But the title of your issues makes me think that you for you there is more you think is "not properly specified". Indeed > Can you point out what else you have issues to understand? I reported this more than 2 years ago and have not worked on any project using Maven for more than 1 year, so I forgot what exactly I had noticed, but I see in the current documentation that it is neither clear what is a valid profile, nor what a profile's effect is when it is activated. The POM Reference contains: > The elements of profiles are as follows: > > <project xmlns="http://maven.apache.org/POM/4.0.0";> > ... > <profiles> > <profile> > <id>test</id> > <activation>...</activation> > <build>...</build> > <modules>...</modules> > <repositories>...</repositories> > <pluginRepositories>...</pluginRepositories> > <dependencies>...</dependencies> > <reporting>...</reporting> > <dependencyManagement>...</dependencyManagement> > <distributionManagement>...</distributionManagement> > </profile> > </profiles> > </project> ... yet the above sources provide examples of profiles which do not have all these elements. Also, [Profiles in POMs](https://maven.apache.org/guides/introduction/introduction-to-profiles.html#profiles-in-poms) says POM profiles can modify "a subset of the `<build>` element", so presumably profiles with some `<build>` elements are invalid. As for the effect, the reference should specify what the effect of an activated profile with a `<dependencyManagement>` element (for example) is. As things stand, some information which defines how profiles behave is only found in _Introduction to Build Profiles_. > Thank you Thanks to you -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
