simplification of the readme for public consumption