From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: David Kastrup Newsgroups: gmane.emacs.devel Subject: Re: Have you all gone crazy? Was: On being web-friendly and why info must die Date: Sun, 21 Dec 2014 22:15:36 +0100 Message-ID: <871tnsg0w7.fsf@fencepost.gnu.org> References: <87388bnzha.fsf@newcastle.ac.uk> <87k31mdbhe.fsf@uwakimon.sk.tsukuba.ac.jp> <87tx0qiv45.fsf@fencepost.gnu.org> <87h9wqd3i5.fsf@uwakimon.sk.tsukuba.ac.jp> <87fvc8kdsp.fsf@gnu.org> <6e11cd85-09a0-4b7a-baa2-0c810bdebbce@default> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1419196576 15347 80.91.229.3 (21 Dec 2014 21:16:16 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 21 Dec 2014 21:16:16 +0000 (UTC) Cc: Tom , emacs-devel@gnu.org To: Drew Adams Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Dec 21 22:16:10 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 1Y2nrE-00052B-Jf for ged-emacs-devel@m.gmane.org; Sun, 21 Dec 2014 22:16:08 +0100 Original-Received: from localhost ([::1]:38346 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Y2nrD-0005VX-TI for ged-emacs-devel@m.gmane.org; Sun, 21 Dec 2014 16:16:07 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:49147) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Y2nqy-0005VO-Lu for emacs-devel@gnu.org; Sun, 21 Dec 2014 16:15:54 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Y2nqx-0002VM-Fn for emacs-devel@gnu.org; Sun, 21 Dec 2014 16:15:52 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:37726) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Y2nqx-0002VI-C4 for emacs-devel@gnu.org; Sun, 21 Dec 2014 16:15:51 -0500 Original-Received: from localhost ([127.0.0.1]:44901 helo=lola) by fencepost.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Y2nqw-0006aW-Ra; Sun, 21 Dec 2014 16:15:51 -0500 Original-Received: by lola (Postfix, from userid 1000) id 6DA28E0C52; Sun, 21 Dec 2014 22:15:36 +0100 (CET) In-Reply-To: <6e11cd85-09a0-4b7a-baa2-0c810bdebbce@default> (Drew Adams's message of "Sun, 21 Dec 2014 13:05:46 -0800 (PST)") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4830:134:3::e 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:180444 Archived-At: Drew Adams writes: >> The younger crowd expects interactive web pages (e.g. jumping to >> manual nodes with completion), because they are used to interactive >> features on other pages (Gmail, facebook, etc.) > > Fine. And it is not only "the younger crowd" that is used to > using interactive web pages. Frankly, that's not really useful since a) every "interactive web page" is different b) they work badly with automated fetchers, so you cannot usefully aggregate them c) they tend to require enabling known security problems like Flash > But for the Emacs and Elisp manuals, in particular, I think that > one of the goals should be to also steer users to *ask Emacs* > itself. > > IOW, let users know that within Emacs they have access to the > Emacs manuals, and that that is really the way to go (for the > reasons already discussed, in particular, index features). > > Yes, this is perhaps a side point. But it is a concern I have. > When a URL sends a user to a manual node on the web, I would > like to see a feature that points back to the manual in Emacs, > e.g., a reminder. We will also want to increase the attractivity of the average HTML manual rendition so that they are actually linked to and come up in web searches. > That's OK if it's a habit or they somehow find it easier, > but they should at least be made aware that they *can* access > the same information from within Emacs, and that they will > get more help and learn more that way than via the manuals > on line. Well, one problem is that the manuals are really effective for learning a lot in one learning session. And that's a good deal for getting better with using Emacs. But it doesn't match modern attention spans. And that's an inherent problem we have with selling Emacs, and it will continue to cost us "market percentages". > The best way we can help them in this regard is to let them > know that Emacs itself offers great help for learning about > Emacs, and one of the best such aids are the Emacs and Elisp > manuals - *within Emacs*. > > Having the information in these manuals at your fingertips > while you use Emacs is an giant plus. Providing better Web > use of the manuals is of course a good idea. But we should > not neglect inviting users to consult the manuals from Emacs. Certainly. But I think that would primarily concern the Emacs-related manuals, so we should probably see to it that one can get the Texinfo conversion process and/or our personal manual CSS sheets to make this a general feature of the Emacs manuals in particular. -- David Kastrup