more comments and better error returning
add Path and Actuator when receiving metadata
prune readme