Rudolf Adamkovič <rud...@adamkovic.org> writes:

> Much improved, but I am not a fan of showing TOC on hover.  Why not
> simply show it always, so one gets an idea what the document is about
> and can comfortably jump where needed?

Note that, on current behavior, you can keep it open by clicking it;
then it won't collapse when the mouse moves out, but only when you click
it again.

If we keep it fixed in the right margin as now, so it's always on hand
whereever you've scrolled in the document, it needs to be collapsed.

Several people have expressed a preference for simply having it always
expanded under the header in the normal document flow. However, some
pages have very long TOCs, so one has to scroll down to see the opening
paragraphs, which if well-written may actually be more helpful than the
TOC for a reader who wants to get an idea what the document is about.
Some possible solutions if we go that way:

1. Keep the TOC under the header and always expanded if it's less than a
   certain length, collapsed/expandable if longer

2. Make sub-entries in the TOC collapsed but expandable

3. Keep the TOC always expanded under the header, but floated right or
   left and at half width, so the opening text can flow beside it (this
   would be the simplest to implement)

Personally, I think the current behavior is fairly elegant and helpful,
and don't feel any urge to change it, but I can think of two
improvements that could make it more helpful yet:

- Providing a hint to the reader about the on-click behavior

- Making it possible to tab to the collapsed TOC from the keyboard
  (another potential accessibility issue)

Yours,
Christian

PS. People who really, really just want plain text in normal flow can always
view the pages with eww, or clone the repository and read the Org
source. :)

Reply via email to