Improvements and readme

This adds improvements to 1.0.0 interface and updates the README