Heading example (Issue 8366)

[JAWS-test]

Each heading following another heading lead in the outline must have a heading level that is less than, equal to, or 1 greater than lead's heading level.

The example after this sentence does not fit the sentence (see #8366). That is why I have adjusted the example.

---

/sections.html ( diff )

[domenic]

This is incorrect; 2 < 4 so the example fits without changes.

[JAWS-test]

@domenic According to the HTML specification, an H4 heading may be followed by an H2 heading, so the current example is logically incorrect, but semantically correct. In my example, an H1 is followed by an H3, which would be logically halfway correct, but semantically wrong, because an H2 would have to be used instead of the H3. I ask not to close my PR, but to merge it.

See your own comment.

[domenic]

I don't understand how you're using the words "logically" or "semantically". The specification is clear on what the expected semantics are.

My comment does not contradict the fact that the current specification's example is correct. (Whether it's logically or semantically correct, I don't know, but it's correct according to the specification.)

[JAWS-test]

@domenic

My comment does not contradict the fact that the current specification's example is correct.

That is exactly the problem. The current example is correct, but the sentence above it says: "The following example is non-conforming". I have thus turned the conforming example into a non-conforming example

[domenic]

I'm so sorry. I missed that context. I think the words "correct" and "incorrect" can be confusing when used to discuss how correct/incorrect a non-conforming example is.

[JAWS-test]

I don't understand how you're using the words "logically" or "semantically".

• logically: Heading structure according to the content of the heading (Apples should be parent to Taste because Taste is a property of Apples).
• semantically: Heading structure according to the level of headings (numbers 1 to 6)

[domenic]

This change looks good, and apologies again for me being confused. Let me know when you or your company has signed the Participant Agreement and we can merge.

[JAWS-test]

@domenic Thank you very much. I have signed the Participant Agreement

[domenic]

Hi @JAWS-test, can you confirm that https://github.com/whatwg/participant-data/blob/main/individuals.json#L4500 is the full name you use to sign legal documents with?

[JAWS-test]

@domenic I sign with the family name. If you need my full name: see my email address, which I have also entered in the form.

[domenic]

Thanks. We need the name you use to sign legal contracts with, which for most people includes their full name. Can you please edit the file I pointed to above (using the GitHub edit UI to send a PR is fine) to fix the signature? As a matter of process, I cannot edit your signature for you.

[JAWS-test]

@domenic I added my first name