Re: learning (names of) markup commands in scheme: documentation

[Bernhard Fisseni]

Hi Lukas,

Lukas-Fabian Moser schrieb am 21.01.22 um 17:15:
> > Also note
[...]
> The standard use case for make-XXX-markup is explained in:
> http://lilypond.org/doc/v2.23/Documentation/extending/markup-construction-in-scheme.html
> under "Known issues and warnings".

I had read that, and it seemed easier to use the "full version", and 
more consistent, too.  But I understand that the data version using 
#:keywords is a little more easy to read once you are used to it

> I would agree that the explanations regarding markups vs. markup lists,
> markup vs. stencils, markup in scheme etc. in the Documentation might be
> improved. We always welcome contributions!

Thank you – I'll see if I understand enough to help ;-).

> (And, your probably noticed
> this: The German documentation is in an effectively unmaintained state
> at the moment. But it seems there's hope this might change soonish.

Actually, the lilypond.org web server was very insistent that even when 
I googled English, I should read German whenever it was available; 
therefore I assumed the versions were on par.  I will think about 
configuring one browser / profile without language preferences so that I 
can access the English version directly.

(For documentation with a specialised audience, I always wonder if such 
divergence between versions would be better avoided with linguistic 
monoculture, but I really appreciate the effort! [And I hope this does 
not sound deprecating – it's not meant to be!, it's just a difficult 
issue.]).

Thanks,
best regards,
  Bernhard