enable rule to be marked as restat or generator
Bump up to v0.1.2

Take the opportunity to fix/update a few things in the package manifest.
Improve the readme, adding the API details