Unify the way we document our APIs. See CONTRIBUTING.md for the rules.
Co-authored-by: Simon Ser <contact@emersion.fr>