I wholeheartedly agree.
I've submitted a section of documentation that was rejected out-right. I was not annoyed by that per say, but the reason claimed 'too specific for most users'. I disagree entirely (perhaps this individual hasn't come across this issue) and I am worried that the the level of documentation is going to be relegated to 'this is how you do this' examples rather than providing a bigger-picture view.
This isn't the community effort that 'Documentation' was sold to be.
For context, my submission was in SQL and explaining the difference/warning between null, dbnull and empty strings. I would put this on the same practical level as database normalisation and understanding the difference between primary/foreign keys & technical/non-technical foreign keys. These are all 'sql' related.
Dismissing based on technical accuracy is one thing (and should be encouraged) but what are my options here?
I am concerned that one person with a big stick can decided they want to avoid imparting a 'bigger picture' understanding. It's this kind of insight that will improve the industry.
Am I to create a competing tag that has less chance of being found?
('practical database theory applications' maybe? sounds fun...)