There is too much personal feeling in your message, I understand why but, please, I did not mean to lecture you on what you should do.
Here is the thing: because this is a recurring heated topic, some experienced project contributors may be on the defensive toward anyone who bring up the subject, expressing more a personal opinion than facts even if their original message is well intended. Just my 2 cents: it would be beneficial to create a new thread on the forum being purely factual where everyone can point out what they think is missing in the current language documentation/ or a github issue which would also pinned in the forum so improvements efforts can be more easily discussed and quantified.
