Hi, probably little bit late to the party, but I’m not quite convinced about simply just recommending common users to skip the usage of “Heading 1” (as per the updated https://dev.xwiki.org/xwiki/bin/view/Community/DocGuide#HTextediting). Because it means there would be one unused heading level offered in the XWiki editor, but also one heading level unused for rendering (while “edit” buttons are only offered next to headings 1 and 2).
Another thing is that the title of the page gets rendered into the 1st <h1> as well as into the <title> element by default. Isn’t that at least partly mitigating the issue with accessibility?
I think the simplest solution to this problem could be to generate <h2> for the current “Heading 1”, <h3> for the current “Heading 2” etc. But I realize this can be problematic, as it would impact styling and there is no <h7> in HTML for mapping the lowest “Heading 6”.
All in all, I do realize there is probably no really easy solution for this problem of “multiple h1 elements on a page”, while considering all related aspects. So which approach would you recommend to users of a regular, company-wide (internal) XWiki instance? And are there no plans to change the XWiki behavior in this regard in the foreseeable future?