> For the basics, beginners can rely on the docs, stackoverflow, this > public mailing list or even AI. I remember watching Sound from > Sounds' videos on Lilypond during the pandemic; they sure helped a > lot. > > But when it comes to more intermediate to advanced features, the > docs are a bit confusing to a developing user. They don't explain > much as needed, or would throw the user to another dense topic (like > functions and Scheme). When push came to shove, I've had to come to > this mailing list (which isn't immediate) or to AI (which might not > always be right). > > I don't think Lilypond or Frescobaldi need to be changed. I guess > the docs could be jacked up a bit, specially because more "plain PC > users" might get frustrated with the "change of pace" and > strangeness of a text based software.
You are more than welcomed to contribute changes to the documentation, or to point out deficiencies, together with suggestions how to improve the text. Especially the Learning Manual should be as good as possible. Note, however, that we have more than 3000 (PDF) pages of documentation in total – and this is only for English. ``` changes.pdf: 25 contributor.pdf: 136 essay.pdf: 40 extending.pdf: 58 internals.pdf: 956 learning.pdf: 219 music-glossary.pdf: 97 notation.pdf: 991 snippets.pdf: 651 usage.pdf: 76 ``` Right now the number of people working on the English documentation is essentially zero. Irrespective of the current lack of manpower, we need user feedback! Developers have a different point of view than beginners. Werner