From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Ted Zlatanov Newsgroups: gmane.emacs.devel Subject: Re: On being web-friendly and why info must die Date: Mon, 08 Dec 2014 20:14:50 -0500 Organization: =?utf-8?B?0KLQtdC+0LTQvtGAINCX0LvQsNGC0LDQvdC+0LI=?= @ Cienfuegos Message-ID: <87d27tk4j9.fsf@lifelogs.com> References: <20141205123549.GA29331@thyrsus.com> <2815659.zRQ0WWWeRr@descartes> <20141205175810.GD3120@thyrsus.com> <87lhmlncb1.fsf@earlgrey.lan> <20141205193643.GB5067@thyrsus.com> <83egsd3kyi.fsf@gnu.org> <871toapbh9.fsf@newcastle.ac.uk> <83ppbuxgxx.fsf@gnu.org> <83mw6yxeij.fsf@gnu.org> <8761dllwds.fsf@fencepost.gnu.org> Reply-To: emacs-devel@gnu.org NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1418087939 23036 80.91.229.3 (9 Dec 2014 01:18:59 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 9 Dec 2014 01:18:59 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Dec 09 02:18:53 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 1Xy9S0-0000ut-VV for ged-emacs-devel@m.gmane.org; Tue, 09 Dec 2014 02:18:53 +0100 Original-Received: from localhost ([::1]:37031 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xy9S0-0007M5-86 for ged-emacs-devel@m.gmane.org; Mon, 08 Dec 2014 20:18:52 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:38172) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xy9Ne-0000wg-59 for emacs-devel@gnu.org; Mon, 08 Dec 2014 20:14:27 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Xy9NY-0007aP-IU for emacs-devel@gnu.org; Mon, 08 Dec 2014 20:14:21 -0500 Original-Received: from plane.gmane.org ([80.91.229.3]:58625) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xy9NY-0007a6-1x for emacs-devel@gnu.org; Mon, 08 Dec 2014 20:14:16 -0500 Original-Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1Xy9NS-0007LK-Im for emacs-devel@gnu.org; Tue, 09 Dec 2014 02:14:10 +0100 Original-Received: from c-98-229-61-72.hsd1.ma.comcast.net ([98.229.61.72]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Tue, 09 Dec 2014 02:14:10 +0100 Original-Received: from tzz by c-98-229-61-72.hsd1.ma.comcast.net with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Tue, 09 Dec 2014 02:14:10 +0100 X-Injected-Via-Gmane: http://gmane.org/ Mail-Followup-To: emacs-devel@gnu.org Original-Lines: 32 Original-X-Complaints-To: usenet@ger.gmane.org X-Gmane-NNTP-Posting-Host: c-98-229-61-72.hsd1.ma.comcast.net X-Face: bd.DQ~'29fIs`T_%O%C\g%6jW)yi[zuz6; d4V0`@y-~$#3P_Ng{@m+e4o<4P'#(_GJQ%TT= D}[Ep*b!\e,fBZ'j_+#"Ps?s2!4H2-Y"sx" Mail-Copies-To: never User-Agent: Gnus/5.130012 (Ma Gnus v0.12) Emacs/25.0.50 (gnu/linux) Cancel-Lock: sha1:PzsJe7fNuzlDby1ERdjkLX8Gts8= X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 80.91.229.3 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:179508 Archived-At: On Mon, 08 Dec 2014 21:27:59 +0100 David Kastrup wrote: DK> Ted Zlatanov writes: >> I was answering your earlier question about evidence. Writing ASCII >> docs and asking you [Eli] to merge them is not fair to you. DK> Shrug. Making use of voluntary work without contributing back anything DK> at all is "not fair", and it's what the majority of Emacs users do. DK> That's more or less a builtin and _wanted_ side effect that the DK> contributors perfectly well are aware of. I mean, I could spend 15-30 minutes and get back to speed. Dumping work on Eli doesn't scale, regardless of how willing he is to take it. But more to the point of this thread, I actually *fear* those 15-30 minutes because it's mostly hunting for "how the hell do you highlight" and "how do you update the index" and "will this break the docs and annoy people" in my long-term memory. It's annoying. By contrast, I can start typing Markdown very quickly because I already use it all the time. This happens for me with any context switch, so I generally tend to work in large blocks instead of switching tasks quickly. As for Asciidoc, I looked into it. It's fairly compatible with Markdown except it has tables and other things codified better, and its own markup, and some of it looks like old-school manpages. I could live with it, if Markdown was not an option (so it would be my second choice). Org markup would still be last on my list because it's indisputably exotic, as much as I like it. So my list of documentation format preferences would be Markdown, then Asciidoc, then texinfo, and last Org. But that doesn't mean I advocate switching, if anyone cares :) Ted