Max Nikulin <maniku...@gmail.com> writes: >> The proposed FAQ entry is overwhelming. It would work fine as a blog, > > A blog with a couple of posts a year has a little sense. Moreover it is > closer to a wiki article because it is supposed to be updated. That is > why I asked for an alternative location on Worg for bonus or extra > material for the manual.
I have no idea about alternative location. Maybe someone more familiar with WORG. Bastien? >> 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. Maybe we can add a proper TOC at the top? Or convert the on-hover TOC into proper one. TOC on top + detailed answers is how many FAQ pages are designed. > I have tried a random query "org-mode renumber footnotes" that is quite > close to an entry from the document. Nether Google nor Bing offered FAQ > on first 2 pages of search results. So FAQ is not friendly to search > engines for some reasons. I am unsure if the rank may be improved by > e.g. microdata schema.org attributes. I wish we had somebody who is familiar with these things. I personally have no idea what can be wrong and where to start to solve this problem. -- Ihor Radchenko // yantar92, Org mode contributor, Learn more about Org mode at <https://orgmode.org/>. Support Org development at <https://liberapay.com/org-mode>, or support my work at <https://liberapay.com/yantar92>