improved exceptions
updated examples
introduced README