Comments under each doc page, for questions and additions?
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.
@Moderation: add a poll please, maybe
OR the ability to edit/add stuff (like a PR)