updating API documentation
improved readme, improved example, some other things
version bump