Should .unlisted be enough to hide from TOC?

[mcanouil]

Description

Take the following document:

---
format: html
toc: true
number-sections: false
---

# A1 {.unlisted}

## B1

### C1

#### D1

## B2

-> all sections are hidden from the TOC.

Now, enable number-sections:

---
format: html
toc: true
number-sections: true
---

# A1 {.unlisted}

## B1

### C1

#### D1

## B2

-> nothing is hidden from the TOC.

From the documentation we can see:

If you want to exclude a heading from the table of contents, add both the .unnumbered and .unlisted classes to it:

source: https://quarto.org/docs/output-formats/html-basics.html#table-of-contents

This means that Quarto does not allow to hide a numbered section from the TOC.
Hiding a section from the TOC means that the section must be unnumbered.

[cscheid]

This means that Quarto does not allow to hide a numbered section from the TOC.
Hiding a section from the TOC means that the section must be unnumbered.

I don't know if this is by design, but I think this design makes sense. If we allow to hide a numbered section, then we either get a skipped number in the TOC (which is weird), or we get a repeated number in the headings themselves (the "unlisted" one and the next).

[mcanouil]

Then should .unlisted do both automatically?

I mean if I want to hide a section I should not have to ask "is my section numbered? If so I have to add .unlisted and .unnumbered, or else my section won't be hidden"

[cscheid]

maybe. I don't know what else .unlisted does by itself, and we'd need to figure that out before deciding.