Additions to readme, refactoring of rest_handler

And the merge of pierce's last outstanding contributions