guile-user
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Flattening the learning curve of guile


From: sirgazil
Subject: Re: Flattening the learning curve of guile
Date: Tue, 11 Dec 2018 10:09:59 -0500
User-agent: Mozilla/5.0 (X11; Linux i686; rv:60.0) Gecko/20100101 Thunderbird/60.3.0

Hi, swedebugia :)

There is a lot one could do to make it easier for beginners to start using Guile. This topic has been discussed before. This is what I think about it:

https://lists.gnu.org/archive/html/guile-user/2017-02/msg00108.html


On 10/12/18 2:07 p. m., address@hidden wrote:
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.


Yes, I've found some places in the manual where examples would be useful. If you find the time to write examples, you can clone the documentation and send patches to Guile (see https://www.gnu.org/software/guile/contribute/).


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
...


Hmm, I don't know about this one. Maybe the tutorials could work for this, and I think the tutorials should be independent documents from the manual.


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.)


I've seen error messages that I found hard to read too, but I didn't take note.


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?


I think the guile for bash scripting tutorial would be a good addition to the currently lonely Tutorials section (https://www.gnu.org/software/guile/learn/).

I guess you could write the tutorial, send it to the mailing list for review, and patch the website to include it in the tutorials section.


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/


Now you could package it for Guix ;) (https://www.gnu.org/software/guix/).





reply via email to

[Prev in Thread] Current Thread [Next in Thread]