updates to test and some usage docs
more README updates