More detail in the README.
Documentation for the YAML spec with examples.
Renamespace fedbadges.models to fedbadges.rules.
Some grammar/language tweaks from @pypingou.
Merge pull request #5 from fedora-infra/feature/docs-and-rename

Feature/docs and rename