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

That article a stub. I wrote it because nobody else would. I'd be happy
if other people can improve it.

> 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

Great.

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

I generally agree with all of the above.

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

Sounds good. Several of us have bought Scheme and Lisp domains. We have
a list here: https://github.com/schemedoc/wiki/wiki/DNS-Domains

> I've noticed thathttp://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.

We could add regional subdomains like pl.scheme.org, but it may become
difficult to follow common rules for Scheme.org between non-English
languages. What do you think?

In particular, I think it's important to keep political and commercial
content off Scheme.org because the Scheme community will never be able
to agree on that stuff.

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

Sounds very good. Thank you for working to improve Scheme's
documentation situation. Would be great to find a home for it under
Scheme.org.

SRFI 211 (Scheme Macro Libraries) is a good overview of Scheme macro
systems [for advanced schemers, not for beginners].