Cooper/readme tuneup

@jstenhouse thanks in advance for your review