I've just visited the staging website to test my Scheme REPL bookmark

https://lips.js.org/#bookmark

it doesn't work before of Content Security Policy. But it works on SRFI that
are simple HTML files without any extra protection.

Any reason why this Content Policy was added?

It would be cool to have this REPL on every page on new website, or
at least that it works there. My Bookmark only use cdn.jsdelivr.net domain to
get the JavaScript files. You should try it.

But I didn't want to talk about this, only about Macros and this page:

https://docs.scheme.org/guide/macros/

This is not even close to be a guide to macros, it don't explain what macros
are. To understand this you need to be Scheme/lisp expert.

You can see Wikipedia article about Scheme:

https://en.wikipedia.org/wiki/Scheme_(programming_language)

I added a lot of information to Polish version mostly about Macros (I'm more
active there). Macro examples are all in English.

https://pl.wikipedia.org/wiki/Scheme

The guild about macros to be useful need to explain the topic like Wikipedia
does or if this official guide on official website it need to do a lot more.

If it can't explain it should at least link to good resources. For Lisp
macros there are a lot of good guides already (onLisp by Paul Graham and Let
Over Lambda) but for Scheme hygienic macros there are no good modern looking
guide. Maybe it's good idea to first write good tutorial on those macros.
Combine all available resources and create single macro tutorial, that will
link to those older files.

For me it was really hard to learn Scheme macros, they was looking weird to
be after I've learned lisp macros. I think that I was afraid of them a bit.
I don't remember but I think that I've also had something like this with Lisp
macros as well. You need to pass the gate to learn them. That's why if we
want people to learn macros we need to explain them well. And a good idea is
for a good guide to teach them both.

PS: I've bought scheme.org.pl and lisp.org.pl I plan to do something with
them, Maybe start a seed for some kind of Polish community (and also for SEO
purpose). If you're in different country consider getting TLD scheme.org
domain.

I've noticed that http://python.org.pl/ is just redirect to
https://pl.python.org/ I may decide in the future to redirect, but for SEO it
only make sense if there are links that point to original domain.

PPS: Now when I know hygienic macros I may write a proper guide when I find
some time. I've created a lot of examples for my unit tests (for LIPS Scheme)
and I think that I know all the inner workings. But it would be nice to get
credit that I'm a autor since this would take a while to create and it would
by a lot of work.

I've started working on Full interactive tutorial, I plan to add REPL for
them. Something more complete and similar to this:

https://blog.klipse.tech/scheme/2016/09/11/scheme-tutorial-1.html

But of course I want to promote my Scheme interpreter.

Right now my tutorial is in larval stage and only in Polish (English will
came later), I plan that If I publish it people will translate it to other
languages. It have a lot of notes what I should include there. But it also
have a lot about macros already.

https://github.com/jcubic/interactive-scheme-tutorial

I'm not sure where I publish it when it's ready, but since it will be
CC-BY-SA you will be able to publish it on scheme.org (of course with
attribution).

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