Unify the way we document our APIs. See CONTRIBUTING.md for the rules.
Co-authored-by: Jason Francis <cycl0ps@tuta.io>