Documentation and readme

Documentation for signature changes and some additional
usage examples.