Unify the way we document our APIs. See CONTRIBUTING.md for the rules.
Closes: https://gitlab.freedesktop.org/wlroots/wlroots/-/issues/3389