doc/README overhaul