cleanup READMEs

The READMEs need cleanup to make sense when pulled together.

cc @Matt-Esch
you lost a `;` here (nitpick)