Please do make those changes and submit a PR. There is a link at the bottom of every page in the docs that will take you to where you can make edits and submit a PR. After a review the changes will almost certainly be accepted and merged. See [Wiki] How to contribute to the openHAB Documentation for an excellent guide.
The docs are the way they are because those who have volunteered to write them did the best that they could. I’m not sure there are any certainly not many contributors who have actual training in technical writing. So if you have suggestion or contributions, please dive in and create a PR. It’s not hard and working together we can make the docs better.
As for the rest, all I’ll say is we all have bad days and some days are worse than others. There are also language translation issues (the majority of users on the forum do not have English as their first language) as well a cultural issues and what comes across as rude to some may be standard to others.
Regardless, please don’t resurrect a years old thread to argue with what someone said or how they said it. We’ll never get anything done if we have to rehash and defend ourselves because we said something years ago in a less than kind way.
You’ll notice that a number of threads automatically get marked as closed after a certain amount of time of inactivity for this purpose (and because it’s easier for everyone to open a new thread rather an reopening an old one). Unfortunately when we made that change we couldn’t apply it retroactively. So for posts made in the last year or so they auto close but for posts older than that like this one that they remain open.