Use the Heroku client to obtain the releases

Patched the logic to cope with the unordered JSON coming back from Heroku
Tidy up on the code and fixed docs