TL;DR - I think we are not doing enough.
I want to open a discussion about documentation and what is important to the community and I see no other place to do that. You can comment but mostly, I would like people to think about these things. And think about what can be done and should be done. And who can do them.
I have worked in the docs team for 2 years. I think we have made some good improvements, but overall the content is not in good shape. I think some of the new pages or chapters are quite good but a general structure is missing and some manuals have not been touched in over a year (or in years) and are frankly in very bad shape. These not so good documentation pages are not just a problem by themselves but also ruin the general impression people get from the docs and causes frustration and demotivation for the people working on them. Also, there is no way for new people to tell if a documentation or Wiki page is outdated.
There is no process or workflow for reviewing the manuals.
There is little coordination. No sprints.
Also, there are very few people reviewing and merging. I am not willing to do this any longer. So currently, there is 1 person left for reviewing and merging.
And then, there is also the Wiki …
To be honest, the documentation content (still) feels like years of neglect even though a few people have been working really hard and doing a great job improving things. But it seems all the effort is like a drop in the bucket. So, why is that?
When I talk about these things I sometimes get answers like:
If it (documentation) were important to people, they would do something about it.
So is it? Is documentation important?