Improving ddoc

[via Digitalmars-d]

On Tuesday, 6 January 2015 at 15:31:52 UTC, Adam D. Ruppe wrote:
> could debate the specific contents of it, h1 works for me but i 
> kinda think h1 should be the outer aggregate name and then h2 
> if it is a nested member... but regardless, ddoc doesn't let 
> you change the macros based on nesting anyway, but it does have 
> the concept of grouped sections with headers.

Well, either way, if ddoc is worth fixing it would be a good idea 
to stick to HTML5 spec since they eventually managed to clean up 
the header mess of HTML4 (somewhat).

http://www.w3.org/TR/html5/sections.html#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements