PROD-365 - doc coverage

boom
Not required for endpoints that are strictly private to the repository, figured it's more important to explain it if it's confusing for private stuff but for public stuff to be totally explicit.