registrator_client: add documentation and TODO comments

i think the logic can still be improved.
also, look for `TODO:`'s.