Cloned from https://bugzilla.redhat.com/show_bug.cgi?id=1216232
Description of problem:
The API documentation for /api/v2/locations (at https://sat.example.com/apidoc/v2/locations.html) does not make any mention of parent locations. This is problematic because it is, in fact, possible to associate a location with a parent organization by POSTing to /api/v2/locations, and also presumably by PUTting to /api/v2/locations/:id.

Version-Release number of selected component (if applicable):
Tested against Satellite-6.1.0-RHEL-6-20150424.0 and Satellite-6.1.0-RHEL-7-20150424.0.

How reproducible:
100%

Steps to Reproduce:
1.Go to https://sat.example.com/apidoc/v2/locations.html. Search for "parent".

Actual results:
No mention of parents.

Expected results:
Mention of the fact that one can associate a location with zero or more parents.

Additional info: