emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: On being web-friendly and why info must die


From: Christopher Allan Webber
Subject: Re: On being web-friendly and why info must die
Date: Fri, 05 Dec 2014 16:00:55 -0600

Eric S. Raymond writes:

> Karl Fogel <address@hidden>:
>> Actually, I think that might be *more* important than the exact choice
>> of markup language.  I hope we don't bikeshed.com the choice of markup
>> language to death.  ${ANYTHING_STANDARD_OR_ORG} is fine by me.
>
> Agreed.  I may have given the impression that I'm more attached to
> asciidoc per se than I am. It would be my first choice, but a reasoned
> case could be made for a couple of the others.

Okay, sorry also that I may be responding to that a bit more than
anything.  Getting GNU's web documentation improved is an important
issue to me, and I really do want this to happen.

I do agree that the importance of good web documentation is more
important than info support, and if somehow we got tossed into the fork
of needing to pick one or the other, I think nice looking web
documentation is more important to the long-term health of GNU.

But!  I'm not convinced we need to lose info support (I somewhat
consider info and texinfo separate matters :)).  I don't think new users
should have to learn info, but if you know it, there's nothing else like
it as in terms of speed to navigate and keybindings.

Not to mention: using something that supports both nicely I think might
be the path of least resistance to get buy-in on this mailing list. :)

Sphinx can already generate very nice and pretty HTML and pretty decent
texinfo/info manuals.  Org-mode might require a lot more tweaking to get
to that point, I don't know.  It might be interesting to take stock of
existing options.

 - Chris



reply via email to

[Prev in Thread] Current Thread [Next in Thread]