slachiewicz opened a new pull request, #76: URL: https://github.com/apache/maven-doxia-site/pull/76
The xdoc, FML and resources pages carried two or three `h1` headings each, left over from the APT and FML conversions. Every other page on the site uses one, so screen readers and any tooling that keys off heading rank saw these three as several documents stitched together. The xdoc page also opened with a `Content` heading above the document title, which put an entry in the table of contents pointing at the table of contents itself. Removing it leaves the title first and the TOC below it. Trailing top-level sections (`Validation`, `Related External Projects`) become subsections. In the xdoc page the four `Validation` subsections drop a further level to stay beneath it, which takes them out of the TOC — the alternative, raising `toDepth` to 3, pulls in the `A subsubsection` sample heading, which has no anchor and renders as an empty link to `#null`. An empty link seemed the worse outcome, but say the word if you would rather keep those four entries and anchor the sample instead. Verified: `mvn clean site` → no `href="#null"` anywhere, TOC keeps all 8 xdoc sections. Independent of #75, which fixes stale content in other files; the two touch no common files. `references/index.md` has the same duplicate-`h1` shape and is corrected there. *This change was created with AI assistance.* -- 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]
