Ernst Reissner created MSITE-988:
------------------------------------
Summary: Documentation
Key: MSITE-988
URL: https://issues.apache.org/jira/browse/MSITE-988
Project: Maven Site Plugin
Issue Type: Bug
Components: documentation
Affects Versions: 4.0.0-M9
Reporter: Ernst Reissner
Create old pre-version 2.0.0 model.
If using newer versions, 4.0.0-M9 to the current M11,
then an error occurs:
```
Site model of
'eu.simuline.m2latex:latex-maven-plugin:maven-plugin:2.0-SNAPSHOT'
for locale 'en' is still using the old pre-version 2.0.0 model.
You MUST migrate to the new model as soon as possible
otherwise your build will break in the future!
```
This is due to an old form of `site.xml`
The first problem is the documentation,
`https://maven.apache.org/plugins/maven-site-plugin/examples/sitedescriptor.html`
which describes the old form and refers to the new one only in a link.
What would be needed is a clear statement on the mapping of the version to the
form.
Also the new form is not completely supported:
```
<site
xmlns="http://maven.apache.org/SITE/2.0.0";
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
xsi:schemaLocation="http://maven.apache.org/SITE/2.0.0
https://maven.apache.org/xsd/site-2.0.0.xsd";>
...
</site>
```
well, the link `https://maven.apache.org/xsd/site-2.0.0.xsd` does not exist,
resulting in a warning in my IDE.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
