Org FAQ design (Re: [PATCH] org-faq.org: Inline comments)

[Max Nikulin]

On 01/07/2023 22:24, Ihor Radchenko wrote:
> Max Nikulin writes:
>
> > > FAQ is probably fine. We may add a CSS there that will fold the
> > > answers by default.
> >
> > When all entries are opened, it is possible to use search in browser. I
> > am against the idea of hiding answers. However the table of contents,
> > that is rather long and revealed on hover only, makes it harder to
> > search in the TOC at first.
>
> I am now watching
> https://fosdem.org/2023/schedule/event/a11y_eaa_bfsg_wcag_wai_aria_wtf/

I have skimmed through the presentation.

> They suggest a combination of <details><summary> to keep hidden text
> searchable. See 
> https://developer.mozilla.org/en-US/docs/Web/HTML/Element/summary

Unsupported by Firefox:

https://bugzilla.mozilla.org/show_bug.cgi?id=1724299
Implement auto-expanding <details>

I am unsure if it is possible to implement auto-expanding on link to 
specific question for Firefox.

However <details> is better than accordions in most cases.

I would consider to put TOC into <details open>

P.S. Have you noticed that MDN pages have "skip to content" link hidden 
by default, but revealed on using keyboard (TAB).