Improvement proposal
The Settings Reference still refers to the settings-1.0.0.xsd:
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 https://maven.apache.org/xsd/settings-1.0.0.xsd">
<localRepository/>
<interactiveMode/>
<offline/>
<pluginGroups/>
<servers/>
<mirrors/>
<proxies/>
<profiles/>
<activeProfiles/>
</settings>
This happens across the whole page. This leads to confusion when one starts with this settings.xml and later tries to apply the Guide to Mirror Settings and reaches the Reference Page from there. That one refers to Version 1.2.0 of the XSD and has a number of possible entries the 1.0.0 version will treat as an error.
While I don't think that all of the possible entries need to be referenced in the Quickstart, I do believe we should use the most current XSD over there. Otherwise a perfectly valid settings.xml will be treated has containing illegal tags until one figures out the XSD entry is too old.
Improvement proposal
The Settings Reference still refers to the
settings-1.0.0.xsd:This happens across the whole page. This leads to confusion when one starts with this
settings.xmland later tries to apply the Guide to Mirror Settings and reaches the Reference Page from there. That one refers to Version 1.2.0 of the XSD and has a number of possible entries the1.0.0version will treat as an error.While I don't think that all of the possible entries need to be referenced in the Quickstart, I do believe we should use the most current XSD over there. Otherwise a perfectly valid settings.xml will be treated has containing illegal tags until one figures out the XSD entry is too old.