updated readme
do some work before returning
minor updates to test scenarios