require to_json to make sure JSON.load/dump is available
add yard docs
updated readme to include a description of how to use it
formatted docs a little nicer