I think the problem is that official documentation is good for 99% of the job. The other 1% is most easily filled in by searching individual problems, which usually results in a stack overflow question, never stack overflow documentation.
My inspiration on how to fix documentation came from Dark Souls messages. In the game, you can't communicate directly with other players, but you can leave messages on the floor that may show up in other players' games. The game intentionally has tricks like fake walls, so messages like "Illusory wall ahead" are common. You can vote a message positive or negative, affecting how frequently it shows up in other games. Unfortunately the player base is also somewhat sadistic, so you often get fake messages (often with another just behind it saying "Liar ahead").
I wish someone would make a browser extension that just allowed you to place little notes on webpages and vote on other peoples' notes. So many documentation problems could be solved with a simple "change <X> to <Y> to make this example work". Documentation maintainers could then just look at the notes on their page to see what they needed to change, instead of waiting for people notifying them of the problem in an official bug report or periodically checking stack overflow looking for issues.
My inspiration on how to fix documentation came from Dark Souls messages. In the game, you can't communicate directly with other players, but you can leave messages on the floor that may show up in other players' games. The game intentionally has tricks like fake walls, so messages like "Illusory wall ahead" are common. You can vote a message positive or negative, affecting how frequently it shows up in other games. Unfortunately the player base is also somewhat sadistic, so you often get fake messages (often with another just behind it saying "Liar ahead").
I wish someone would make a browser extension that just allowed you to place little notes on webpages and vote on other peoples' notes. So many documentation problems could be solved with a simple "change <X> to <Y> to make this example work". Documentation maintainers could then just look at the notes on their page to see what they needed to change, instead of waiting for people notifying them of the problem in an official bug report or periodically checking stack overflow looking for issues.