slachiewicz opened a new pull request, #1838: URL: https://github.com/apache/maven-site/pull/1838
Rewrites the Doxia entry pages, which still described Doxia 1.x. The front page now starts from what a visitor wants to do (write a site, or write a report or extension) instead of a feature list, and the overview, modules guide, gotchas, FAQ, downloads, resources and developer index match Doxia 2.2. Corrections a reader would otherwise trip over: - Figures render as `<figure>`/`<figcaption>`; the old gotcha described Doxia 1 output and deprecated method variants. - An APT link without `./` silently becomes a same-page anchor (`#doxia-apt.html`); Doxia does not warn, even with `-X`. - FML is marked deprecated since 2.2.0 (apache/maven-doxia#1101) on the front page, the modules guide and the references table. - The FAQ no longer claims an XSD cache in `java.io.tmpdir`, and drops the Book and Document schema examples of the retired renderers. - The overview no longer says Doxia uses Plexus; components are JSR-330. - Dead links (XWiki SVN, archived Mylyn incubator) are replaced or removed. Every anchor of the published pages is kept; renamed headings carry their old id. `downloads.md` becomes `downloads.md.vm` so the version is filtered; the URL stays `downloads.html`. The module pages in apache/maven-doxia get a matching refresh in a separate PR. Verified: `mvn verify site` → passes; every id on the nine live pages still exists in the build, and all internal links resolve. The accessibility check was not run locally. --- - [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]
