add rules to the readme

Summary:
Also improve wording in a few places and clarify the relationship
between `PERU_DIR` and `PERU_CACHE`

Reviewers: sean