I think this is a great idea.
Ideally the API reference section of the docs could be a combination of auto-generated from code, plus community additions. The latter could be toggled on/off, or filtered by some sort of confidence/verification measure of its correctness.