readme overhaul

fix tests