yet another Guile tutorial for Linux (work in progress)

yet another Guile tutorial for Linux (work in progress)

[Basile Starynkevitch]

I am writing yet another Guile tutorial. It is work in progress and 
available on http://starynkevitch.net/Basile/guile-tutorial-1.html under 
CC-BY-SA 3 license.

Your comments are welcome.


Thanks

-- 
Basile Starynkevitch (92340 Bourg La Reine, France)
http://starynkevitch.net/Basile/ <basile@starynkevitch.net>
Opinions are only mine - mes opinions ne sont que miennes
(tel. mobile: cf my web page / voir ma page web)

Re: yet another Guile tutorial for Linux (work in progress)

[Hans-Werner Roitzsch]

Hi Basile,

I like the many links to relevant resources.

The literature advice is a bit too easily written there: "I greatly
recommend reading Queinnec's Lisp in Small Pieces book (after SICP and
this tutorial)." – Yes, I also recommend SICP to many people and whoever
asks me about programming books, but I think a note about how many pages
that book has and that one can need a long time to go through it
including doing the exercises would be good to add ; ) Imagine someone
reading your page and thinking: "Oh well, gonna read (and understand)
that and will be back next week." By the time they are finished with
that book, they wont even remember the website any longer.

The styling of your page could be a bit more uniform. There are many
different styles like:

* italics
* italics + bold
* bold
* link color + underlined
* bigger font for headings
* code in monospaced with a red color on a background of another color
* dark blue + bold for file names
* code + output in green and italic
* color changes in code + output
* code in one line / code in a code block

and more. I would recommend limiting the variety a bit more here, as it
becomes a bit difficult to read, when there is so much variety in font,
color and background.

I like the content, keep going : )

Regards,

Zelphir


On 8/5/19 10:14 AM, Basile Starynkevitch wrote:
> I am writing yet another Guile tutorial. It is work in progress and
> available on http://starynkevitch.net/Basile/guile-tutorial-1.html
> under CC-BY-SA 3 license.
>
> Your comments are welcome.
>
>
> Thanks
>

Re: yet another Guile tutorial for Linux (work in progress)

[Mark H Weaver]

Hi Basile,

Basile Starynkevitch <basile@starynkevitch.net> writes:

> I am writing yet another Guile tutorial. It is work in progress and
> available on http://starynkevitch.net/Basile/guile-tutorial-1.html
> under CC-BY-SA 3 license.
>
> Your comments are welcome.

Thanks for this.  I will try to find time to review it more carefully at
some point, but for now I have just one comment:

When referring to the operating system, please give GNU proper credit by
calling the system "GNU/Linux".  Linux is a kernel, not an operating
system.  The practice of calling the entire system "Linux" does great
harm to the GNU project, and arguably to the free software movement as a
whole, by greatly reducing the number of users of GNU/Linux systems who
learn about the crucially important freedoms that we are trying to
protect.

Anyway, I'm not sure why GNU/Linux is relevant to much (if any) of this
tutorial.  From a quick skim, I don't see anything here that wouldn't
work on FreeBSD, Solaris, or OS X.  Most of it would be the same on
Windows, for that matter.  The kernel is certainly not relevant.

Also, what do you mean by a "Linux developer"?  Do you mean to refer to
free software developers, or POSIX developers, or GNU/Linux developers,
or software developers in general?

It seems to me that most of the references to "Linux" are superfluous,
because almost all of this will work on any system that Guile supports.

What do you think?

      Regards,
        Mark