I understand this very well, I'm just astonished to hear that this is
all the documentation you and some others want to see or have. It's
completely against all I have ever learned and practiced in the way of
teaching people various skills and topics (and I did that more than
once or twice).
No this is not what we are saying. Tutorials are not the only documentation I and others want to see.
We like to switch between tutorials and full-blown documentation at different times depending on various factors. In Emacs there's only the full-blown documentation.
Emacs has a wealth of documentation at your fingertips, arranged,
indexed, and enriched with a large collection of commands designed to
make our self-documenting editor easy to study. To give up all of
this and insist on having instead a flat list of APIs that match some
textual pattern is something that comes as a shock to me.
We are not giving up on it. Some might but at least not me.
Philippe