add more documentation to the readme

We should have slightly more info in the readme for this repo; general info about the rule sets; how to configure an analysis options file to use the rule sets; where to find more info about available rules, ...