Document structure seems odd to me.

[jenstroeger]

Looking at Document reference sections it’s followed by three unnumbered sections of the same visual level: Indexes, Glossaries, Bibliographies. Looking at the DOM, though, those three seem to be sub-sections:

However, they’re using H2 headers, and yet aren’t listed in the page’s TOC alongside other H2 headings. I think they should either be H3 or should be equally listed in the TOC; I lean towards to former because the three are indeed reference sections.

[mattgarrish]

I think they should either be H3

Yes, and the divs should really also be sections. The document used to be dynamically generated from an n3 file and we just took a static snapshot of the output when we moved away from that process. I wouldn't be surprised if there are other oddities lurking in it.

[jenstroeger]

So, what’s the plan with these documents now?

Maintain the HTML or move to some other meta format, e.g. Markdown or, considering the documentation is already hosted on Github, to Wiki or some such?

[mattgarrish]

Couldn't say at this time. Will have to see what taking epub to rec in w3c entails. My guess would be it gets re-done in respec without all the RDF vocab stuff.