OK, so I gather this is a proposal to improve the reference manual?
If so, good. But what about the overall structure of the documentation?
If you think about the recent thread, most of the misconceptions and
misperceptions can be tracked back to a confusion about where to go to get what.
I think it would be good to have a broad and not too shallow look at
what the documentation should look like to someone new to the language, starting
with the “Documentation” button.