TOC heading as "On this page" or something else?

[chalin]

The feature being discussed, is whether the right-nav TOC should have a heading. Options include:

• "On this page" - e.g.,

  • https://docs.flutter.dev/ui

    

  • https://getbootstrap.com/docs/5.3/getting-started/introduction/

    

  • https://docs.netlify.com/get-started/

  • https://docs.astro.build/en/concepts/why-astro/

  • https://prometheus.io/docs/prometheus/latest/getting_started/

• "Contents" - e.g.:

  • https://dart.dev/language
  • https://grpc.io/docs/languages/go/quickstart/, see the in-page TOC on narrow displays

    

• Page title, as proposed below

---

Originally posted by @MarkvanMents in #2287 (comment)

Looks nice.
I don't particularly like the On this page - our solution is to have the document title at the top with an href to take the reader all the way to the top of the document.

We also don't have the selected line indented, we just add the bar to the left and add bold.
But would be nice to have this OOTB in Docsy.

---

Tasks

• Experimental implementation: Add support for BS ScrollSpy to show active TOC entry #2287
• ...

[chalin]

@MarkvanMents - nice. How do you manage long titles?

[MarkvanMents]

We avoid them 😂
Or wrap them

[LisaFC]

I personally like On this page for clarity (this is a TOC for the page you're looking at right now, none of these headings bring you to other pages), page title feels a bit repetitive and I'm not as fond of Contents. Can we make On this page the default and have an option to change it if you want?