updated readme with exceptions and end-to-end test descriptions