improved readme and testing coverage