Prepare documentation for 1.0 release

This PR includes changes for documentation/readme file that relates to the `1.0` release (will close #129).