added docs
cribbed from balance service.pp
update the docs
still needs to be tested
filling in the logic
skip using ip param
adjust for remove of ip param