update readme

add better usage examples, explain in greater detail what specs
are supported, and add the packagist URL