From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: swedebugia@riseup.net Newsgroups: gmane.lisp.guile.user Subject: Flattening the learning curve of guile Date: Mon, 10 Dec 2018 11:07:21 -0800 Message-ID: <7001e20ec2418873e9672cb8d91a6269@riseup.net> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit X-Trace: blaine.gmane.org 1544468758 4034 195.159.176.226 (10 Dec 2018 19:05:58 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Mon, 10 Dec 2018 19:05:58 +0000 (UTC) To: Guile User Original-X-From: guile-user-bounces+guile-user=m.gmane.org@gnu.org Mon Dec 10 20:05:54 2018 Return-path: Envelope-to: guile-user@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gWQsH-0000r3-Ue for guile-user@m.gmane.org; Mon, 10 Dec 2018 20:05:50 +0100 Original-Received: from localhost ([::1]:34385 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gWQuO-0003yK-Ap for guile-user@m.gmane.org; Mon, 10 Dec 2018 14:08:00 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:42881) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gWQts-0003xE-Tw for guile-user@gnu.org; Mon, 10 Dec 2018 14:07:30 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gWQtn-0002jB-TA for guile-user@gnu.org; Mon, 10 Dec 2018 14:07:28 -0500 Original-Received: from mx1.riseup.net ([198.252.153.129]:45596) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1gWQtn-0002iV-F1 for guile-user@gnu.org; Mon, 10 Dec 2018 14:07:23 -0500 Original-Received: from piha.riseup.net (piha-pn.riseup.net [10.0.1.163]) (using TLSv1 with cipher ECDHE-RSA-AES256-SHA (256/256 bits)) (Client CN "*.riseup.net", Issuer "COMODO RSA Domain Validation Secure Server CA" (verified OK)) by mx1.riseup.net (Postfix) with ESMTPS id 90CAB1A35E4 for ; Mon, 10 Dec 2018 11:07:21 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=riseup.net; s=squak; t=1544468841; bh=x/b3KFraS/SEE3WK+4WhiR/jaVgzcnbDW9erth6T/kY=; h=Date:From:To:Subject:From; b=TX9MsqujPHiHY7cadylD8bZuoV/PMO/7NXgVuXavvXWXsysffGVik7DAVy1biQhmC saVK6xyAgiJ0+8KzD720n8v0rZyqFkDM3QjHaV96vnx+rNSyItkuEPhlA9IvVamvok ZXVAnqVHGNEI6rS8A89MA1GNLsIsIe1GA9QsWXmw= X-Riseup-User-ID: 954736FD6BB88DBC544AD48B2F43375315DB7BB9C6FC3278A7490EB5A843AF63 Original-Received: from [127.0.0.1] (localhost [127.0.0.1]) by piha.riseup.net with ESMTPSA id 5337F6A5F6 for ; Mon, 10 Dec 2018 11:07:21 -0800 (PST) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 198.252.153.129 X-BeenThere: guile-user@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: General Guile related discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guile-user-bounces+guile-user=m.gmane.org@gnu.org Original-Sender: "guile-user" Xref: news.gmane.org gmane.lisp.guile.user:15043 Archived-At: Hi I would like to help improve the manual because the learning curve is pretty steep at the moment (to me at least) and there a surely many good examples and helpful think-this-way to put into it. We could have a whole new section with: i want to do this: x in guile this is best done with bla bla, see this project i want to do this: y in guile this is best done with bla bla, see this example ... Also the error messages really need an overhaul. Eg. the "wrong type"-error is cryptic at best and often you have no idea where it originates. (I noticed this in my wikidata library where it would pop up from a low level.) Also it would be nice to update the guile-webpage with personal stories how people use guile and a tutorial about porting bash-scripts and making simple scripts in guile. (we really want people to use guile instead of bash-scripts don't we? With simple scripts I mean a script with a main that does something with 100 lines max. My wikidata library is already way past this so I guess I'm beyond simple scripting already! \o/ Any thoughts? -- Cheers Swedebugia