From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Christopher Allan Webber Newsgroups: gmane.emacs.devel Subject: Re: On being web-friendly and why info must die Date: Fri, 05 Dec 2014 16:00:55 -0600 Message-ID: <87d27xn3jh.fsf@earlgrey.lan> References: <20141205123549.GA29331@thyrsus.com> <87mw72lyzs.fsf@earlgrey.lan> <20141205190925.GA5067@thyrsus.com> <871tod241v.fsf@ktab.red-bean.com> <20141205212111.GB7784@thyrsus.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1417817956 24565 80.91.229.3 (5 Dec 2014 22:19:16 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 5 Dec 2014 22:19:16 +0000 (UTC) Cc: Karl Fogel , emacs-devel@gnu.org To: esr@thyrsus.com Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Dec 05 23:19:11 2014 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Xx1DR-0003Gu-6z for ged-emacs-devel@m.gmane.org; Fri, 05 Dec 2014 23:19:09 +0100 Original-Received: from localhost ([::1]:52693 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xx1DQ-0002RB-JC for ged-emacs-devel@m.gmane.org; Fri, 05 Dec 2014 17:19:08 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:60499) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xx1DM-0002Qz-BG for emacs-devel@gnu.org; Fri, 05 Dec 2014 17:19:05 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Xx1DL-0001JD-9w for emacs-devel@gnu.org; Fri, 05 Dec 2014 17:19:04 -0500 Original-Received: from [2600:3c02::f03c:91ff:feae:cb51] (port=36986 helo=dustycloud.org) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xx1DL-0001J9-3S for emacs-devel@gnu.org; Fri, 05 Dec 2014 17:19:03 -0500 Original-Received: from earlgrey.lan (localhost [127.0.0.1]) by dustycloud.org (Postfix) with ESMTPS id 024AB26628; Fri, 5 Dec 2014 17:19:01 -0500 (EST) In-reply-to: <20141205212111.GB7784@thyrsus.com> X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2600:3c02::f03c:91ff:feae:cb51 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:179042 Archived-At: Eric S. Raymond writes: > Karl Fogel : >> 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