News for hackers. Stuff that matters.
Re:Asciidoctor – A fast, open-source text processor and publ... by warent on Monday January 07, 2019 @03:49PM (#18849896)
There's a couple reasons why I think it would be bad if higher level headings would be considered more important. First, in HTML, <h1> is the top heading which directly maps to

= heading

If you were to do it the other way around, there's no easy way to know which would would map to h1

======= this?

============= this?

The second reason why is because you have to have a baseline of maximum-importance. It's like ticket priorities capping out at P0 for maximum priority. The first intuitive thought would be that P5 should be more important than P0, but if you don't set a baseline of maximum importance, then there will always be someone who feels their thing is slightly more important.

========== Top level heading

=========== Super top level heading

============== Extra super top level heading deluxe

Re:Asciidoctor – A fast, open-source text processor and publ... by Someone on Monday January 07, 2019 @05:30PM (#18850923)
Another argument in favor of adding markers for lower levels is that indenting the first character of a header typically indicates lower level headings in a table of contents.

    Chapter 1 ............... 5
     Section 1a ............. 7
     Section 1b ............ 11
    Chapter 2 .............. 17
     Section 2a ............ 21
is nicely similar to

    # Chapter 1
    Lorem ipsum dolor sit amet.
    ## Section 1a
    Lorem ipsum dolor sit amet.
    ## Section 1b
    Lorem ipsum dolor sit amet.
    # Chapter 2
    Lorem ipsum dolor sit amet.
    ## Section 2a
    Lorem ipsum dolor sit amet.
Re:Asciidoctor – A fast, open-source text processor and publ... by smartmic on Monday January 07, 2019 @04:01PM (#18850014)
From a technical implementation point of view, I agree. But I had the viewpoint of a visually guided human, the non-technical type.

That is also why I stick to reStructeredText, they circumnavigate ATX-style headers at all.

Re:Asciidoctor – A fast, open-source text processor and publ... by smartmic on Monday January 07, 2019 @04:11PM (#18850126)
Concerning the baseline, doesn't the HTML5 standard just specify 6 ranks from <h1> … <h6>? Would be at least a candidate for common agreement on the lowest (highest) rank.
Re:Asciidoctor – A fast, open-source text processor and publ... by occamrazor on Monday January 07, 2019 @04:37PM (#18850418)
HTML5 also supports nestet <section> with their <h> tags. I’m not sure if there is a maximum nesting level in this case.