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]

Reply via email to