Unify the way we document our APIs. See CONTRIBUTING.md for the rules.
Document some of the assumptions for DMA-BUF buffer sharing and modifiers.