[WORK IN PROGRESS] developer documentation for the v2 api standards

included in this discussion are the actual API v2 standards themselves for Foreman and Katello