From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Christopher Allan Webber Newsgroups: gmane.lisp.guile.devel Subject: Re: Ideas for a Guile tutorial to go with the new site Date: Mon, 19 Oct 2015 11:29:21 -0500 Message-ID: <878u6ykefz.fsf@dustycloud.org> References: <87k2qkjh74.fsf@dustycloud.org> <69725d37e4da310143317b42e5cb35b1@openmailbox.org> <99386b9819329acfaad40d03deef0892@hypermove.net> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1445272296 989 80.91.229.3 (19 Oct 2015 16:31:36 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 19 Oct 2015 16:31:36 +0000 (UTC) Cc: guile-devel-bounces+amirouche+dev=hypermove.net@gnu.org, guile-devel To: Amirouche Boubekki Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Mon Oct 19 18:31:35 2015 Return-path: Envelope-to: guile-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 1ZoDLS-0003r5-OB for guile-devel@m.gmane.org; Mon, 19 Oct 2015 18:31:34 +0200 Original-Received: from localhost ([::1]:40920 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZoDLS-00030t-4Q for guile-devel@m.gmane.org; Mon, 19 Oct 2015 12:31:34 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:42616) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZoDLL-0002sw-Hi for guile-devel@gnu.org; Mon, 19 Oct 2015 12:31:28 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZoDLK-0001Vq-E7 for guile-devel@gnu.org; Mon, 19 Oct 2015 12:31:27 -0400 Original-Received: from dustycloud.org ([2600:3c02::f03c:91ff:feae:cb51]:52889) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZoDLK-0001Vm-AR for guile-devel@gnu.org; Mon, 19 Oct 2015 12:31:26 -0400 Original-Received: from earlgrey (localhost [127.0.0.1]) by dustycloud.org (Postfix) with ESMTPS id 7CD4F26651; Mon, 19 Oct 2015 12:31:24 -0400 (EDT) In-reply-to: <99386b9819329acfaad40d03deef0892@hypermove.net> 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: guile-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Developers list for Guile, the GNU extensibility library" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Original-Sender: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.lisp.guile.devel:17939 Archived-At: Amirouche Boubekki writes: > To the contrary I think it's not a good idea to start upfront the > tutorial with which editor should be used is a good way to loose half of > the readers, because they will feel more uncomfortable and not up to the > task. To be useful emacs requires one 'Getting Started' tutorial in > itself. Or anykind of setup for that matter. The tutorial should go as > quickly as possible to the matter and start with coding. > > I started a tutorial at http://hypermove.net/. I don't introduce > readline until the user knows what the REPL is. Part 1 is all done in > REPL. I subtly introduce emacs as a good choice for an editor in part 2 > which is done in an editor. But doesn't enforce it. Okay, sorry if I wasn't being clear... my goal in that section would be to encourage everyone who *isn't already an emacs user* to pick up a simple editor and know how to use that with Guile, but them give them a brief tip that they want to look into Emacs + Geiser once they've dived in a bit more deeply. I don't think this section needs to be too long. I agree it should not be overwhelming. >> The "Getting up and running" section looks like a good part to start >> materializing the tutorial. > > I sent a previous mail to the ML describing my work. Again feel free to > comment. We discussed this on IRC, but I think your tutorial and the one I proposed above target different audiences, which is great! Having multiple tutorials is very helpful.