Thank you very much for taking the initiative on this. Much appreciated! I agree the documentation should be improved to aid new users, in particular. I agree the lack of solid documentation is one of the major short-comings.
One source of documentation is the pimatic-guide project where everybody is invited to contribute - https://github.com/pimatic/pimatic-guide. The project is written in Markup-Style which is fairly easy to learn and also suitable for users who are not familiar with programming stuff. Contributions can be made via pull requests - which is easy, but obviously needs some explanation for users not familiar with github. Alternatively, user can simply post their contributions on Forum or create an issue on github.
API-documentation is generated from source and I strongly believe this is the way to go. Other projects which used Wikis for that are now switching back to documentation generated from source as the Wiki stuff ended up in a complete mess. A popular example for that is the J5 project.
For any outher documentation like Trouble Shooting, How-Tos, and such, I think a Wiki would be really helpful and serve better than forum posts. I think it is very easy to run Wikis as part of github projects and it is also possible to render them into a web site similar to what we have for pimatic-guide.
We’ll discuss the matter and get back to you shortly.