On Tue, 29 Dec 2020 22:16:00 +0200
Lassi Kortela <xxxxxx@lassi.io> wrote:

> > I've started working on Scheme tutorial it's a draft and only in Polish,
> > but it have code examples that you can look at the code is in English. I
> > plan to finish it I hope I will have time in 2021. And translate it to
> > English. And I hope that others would join and translate it to other
> > languages.
> >
> > I wanted it to be crash intro course that include everything that is
> > important. The license is Creative Commons Attribution share-alike.
> >
> > The idea is to make it interactive, I was thinking about sidebar with
> > REPL or bottom one, like my bookmark that work on any website.
> >
> > Another idea is to use something like Klipse quick intro to Scheme[2],
> > Klipse itself is Open Source, but the tutorial is not.
> >
> > [1]:https://github.com/jcubic/interactive-scheme-tutorial/blob/master/pl/index.md
> >
>
> Looks good and covers quite advanced topics for a beginner tutorial.
> That may be a good thing - Scheme is a good language for experienced
> programmers, and we should do more to market that fact.
>
> > [2]:https://blog.klipse.tech/scheme/2016/09/11/scheme-tutorial-1.html
>
> Likewise, looks great.
>
> There's also:
>
> - https://en.wikibooks.org/wiki/Scheme_Programming
> - https://ds26gte.github.io/tyscheme/ (classic, r5rs?)
> - https://web-artanis.com/scheme.html (guile)
> - https://riptutorial.com/scheme (chicken)
> - probably others
>
> It would be great to synthesize one comprehensive tutorial from these
> ones to put under Scheme.org, if you're open to the idea. We may have
> some others who are also interested in working on a tutorial, but I'm
> not sure how to best find them.

>
> https://github.com/schemedoc is a reasonably big GitHub organization to
> collaborate on Scheme documentation on all kinds. The idea is to put
> most of it under Scheme.org when it's ready. I can add you if you want.

One thing to have in mind https://schemer.in/slogan/ look at function names
if you hover over, there is underscore and they are links. I've also seen some
effort not remember where to show something like tooltips on hover over
builtin names probably generated from Emacs maybe on Reddit. I'm Not sure how
other Scheme implementations are created but in LIPS every builtin function or
macro have doc strings, I've even added support for variables to it work with
syntax-rules macros.

With LIPS I can show docs on each function or macro. Docs can even be
extended to show examples. Like --> macro have. In REPL you can call:

(help -->)

It was inspired by GNU Emacs that have builtin help. Maybe I will create
min.js file without doc strings to make size smaller.

There is lot of things you can do to make learning Scheme fun experience.

Another nice example, but with bad UX is Picture language demo from SICP[1].

[1]: https://www.biwascheme.org/demo/pictlang.html

--
Jakub T. Jankiewicz, Web Developer
https://jcubic.pl/me