From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Stephen J. Turnbull" Newsgroups: gmane.emacs.devel Subject: Re: Intermediate tutorial shipped with Emacs Date: Sat, 19 Sep 2015 17:18:15 +0900 Message-ID: <876136zut4.fsf@uwakimon.sk.tsukuba.ac.jp> References: <87a8sjcfr6.fsf@earth.catern.com> <834miqrhza.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 X-Trace: ger.gmane.org 1442650720 3465 80.91.229.3 (19 Sep 2015 08:18:40 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 19 Sep 2015 08:18:40 +0000 (UTC) Cc: Spencer Baugh , emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Sep 19 10:18:32 2015 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 1ZdDLr-000529-0t for ged-emacs-devel@m.gmane.org; Sat, 19 Sep 2015 10:18:31 +0200 Original-Received: from localhost ([::1]:44383 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZdDLq-0007Ju-8p for ged-emacs-devel@m.gmane.org; Sat, 19 Sep 2015 04:18:30 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:40920) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZdDLl-0007JH-Qz for emacs-devel@gnu.org; Sat, 19 Sep 2015 04:18:26 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZdDLl-0005Ms-02 for emacs-devel@gnu.org; Sat, 19 Sep 2015 04:18:25 -0400 Original-Received: from shako.sk.tsukuba.ac.jp ([130.158.97.161]:41373) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZdDLh-0005I0-0q; Sat, 19 Sep 2015 04:18:21 -0400 Original-Received: from uwakimon.sk.tsukuba.ac.jp (uwakimon.sk.tsukuba.ac.jp [130.158.99.156]) (using TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by shako.sk.tsukuba.ac.jp (Postfix) with ESMTPS id 1997B1C39C6; Sat, 19 Sep 2015 17:18:16 +0900 (JST) Original-Received: by uwakimon.sk.tsukuba.ac.jp (Postfix, from userid 1000) id E5AF411EF83; Sat, 19 Sep 2015 17:18:15 +0900 (JST) In-Reply-To: <834miqrhza.fsf@gnu.org> X-Mailer: VM undefined under 21.5 (beta34) "kale" cb65bfaf7110 XEmacs Lucid (x86_64-unknown-linux) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 130.158.97.161 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:190079 Archived-At: Eli Zaretskii writes: > Past discussions more or less concluded that there should be a series > of intermediate-level tutorials, each one covering topics in some > distinct area. So the topics you present above, that are unrelated to > each other and probably reflect your personal interests (or even some > random selection) are probably not the way to go. +1 to "probably". I didn't resonate to that list myself, but I can't really say that "most" new users wouldn't. > That's a challenge in itself: how do you give "a taste" of a feature > without describing it in full, or close to that. "Not describing it in full" is pretty much the definition of "a taste". I would envision this intermediate tutorial as a series of "HOWTO" do common tasks. It would only explain enough of the feature to implement the HOWTO, and provide links to the manual. > > So, I wanted to see if emacs-devel thought this was a good idea, > > or a bad idea, or if anyone had any suggestions. I would be happy > > to adapt the document I've already written if that makes sense. I think that's the way to go. Maybe post it or a link to it on the EmacsWiki.