Re: Improving the presentation of Emacs user documentation

[Xue Fuqiao]

On Mon, Feb 8, 2016 at 7:19 AM, John Wiegley <address@hidden> wrote:
> A Spacemacs user just showed me:
>
>     http://spacemacs.org/doc/DOCUMENTATION.html
>
> And compared it to:
>
>     https://www.gnu.org/software/emacs/manual/html_mono/emacs.html

As a relatively new Spacemacs user, here are some problems I see in the
Spacemacs docs:

1. There is no indices[1][2].

2. The anchors are unstable, like the '#orgheadline180' part in:
http://spacemacs.org/doc/DOCUMENTATION.html#orgheadline180
Although Emacs's URIs are not permanent either[3], Spacemacs's links are even
more unstable.

3. I can't use convenient key bindings in Info like 'm', '1 .. 9', 'n', 'p', and
'^' to browse Spacemacs's docs.

Anyway, the CSS styles of the Spacemacs docs are beautiful.

Footnotes:

[1] 
https://www.gnu.org/software/emacs/manual/html_node/emacs/Concept-Index.html#Concept-Index
[2] https://www.gnu.org/software/emacs/manual/html_node/elisp/Index.html#Index
[3] https://lists.gnu.org/archive/html/emacs-devel/2016-01/msg00079.html