965283 - updating the REST API docs for repo updates as they pertain to ...

...importers and distributors

this mostly fulfills https://bugzilla.redhat.com/show_bug.cgi?id=965283