slachiewicz opened a new pull request, #1363: URL: https://github.com/apache/maven-site-plugin/pull/1363
Brings the plugin's usage, FAQ, migration and example pages in line with master ahead of 3.23.0. Several pages stated behavior that no longer holds: - Deploying: only `file:` URLs work out of the box. The HTTP Wagon that ships with Maven cannot copy a directory, and WebDAV needs `wagon-webdav-jackrabbit`. The error quoted on the protocol page no longer exists, so the page now shows the real messages. - FAQ: the project `<url>` is used to relativize site descriptor links (`relativizeSiteLinks`), so the plugin does use it. Entities declared in a DOCTYPE work only when their value is a character reference; plain-text entities render empty, with or without validation. - Migration: a 3.22.x to 3.23.0 section covers the Maven 3.9.0 floor, `site:run` on the JDK HTTP server, and `-D` properties in the site descriptor. The Maven 2 and Doxia 1.1 notes are folded into one section that keeps their anchors, and the Velocity 1.5 downgrade advice is gone. - Configuring reports: the part that repeats the site guide is now a link to it; the report set example uses current plugin versions. - `site:run` and `site:auto-refresh`: documents `host`, `-Dport=0`, and that `auto-refresh` does not watch in batch mode. This PR does not touch `index.md.vm`, `site.xml` or `README.md`, which open PRs change. Verified: `site:run`, `site:stage`, `site:deploy` (file, scp, http, dav), `site:auto-refresh`, `moduleExcludes` and `-D` interpolation on a scratch project with 3.23.0-SNAPSHOT → log lines quoted on the pages are from those runs; no anchor of the live pages disappears. --- To make clear that you license your contribution under the [Apache License Version 2.0, January 2004](https://www.apache.org/licenses/LICENSE-2.0) check one of the following: - [x] I hereby declare this contribution to be licensed under the [Apache License Version 2.0, January 2004](https://www.apache.org/licenses/LICENSE-2.0) - [x] I hereby declare that I have filed an [Apache Individual Contributor License Agreement](https://www.apache.org/licenses/icla.pdf). -- 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]
