Comments under each documentation page

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.