Shorten the README and add examples

Descriptions of rules and how to configure them have been moved into a
separate docs folder.