One thing I liked about the about titles from OG AsciiDoc is that titles can be used more like an annotation rather than needing to be a physical <h*> heading. What this means is that it this title does not become a part of the document outline. If I wanted a heading like that I would have used ======. According to the spec, headings like this seem to be a suggestion and not a requirement as there are a lot of sections that don't need this type of outlining header. However, I'm actively willing be told this is a bad assumption about browsers and other readers perceive the document, as well as better understand the HTML spec. To me, it seems like maybe <header> makes more sense without any specified <h*> as it's not a requirement and isn't treated as a part of the outline, but not entirely sure.
One thing I liked about the about titles from OG AsciiDoc is that titles can be used more like an annotation rather than needing to be a physical
<h*>
heading. What this means is that it this title does not become a part of the document outline. If I wanted a heading like that I would have used======
. According to the spec, headings like this seem to be a suggestion and not a requirement as there are a lot of sections that don't need this type of outlining header. However, I'm actively willing be told this is a bad assumption about browsers and other readers perceive the document, as well as better understand the HTML spec. To me, it seems like maybe<header>
makes more sense without any specified<h*>
as it's not a requirement and isn't treated as a part of the outline, but not entirely sure.