Cleanup documentation issues in the service portal api

Since the swagger yaml is used to drive documentation we should clean it up for 
- grammatical errors, typos etc.
- licensing 
- email addresses
- official product names
- common terminology 


https://github.com/ManageIQ/service_portal-api/blob/master/public/doc/swagger-2.yaml