Clean up the README
Clean up the README

This mostly just fixes up formatting and a few other things. It still
needs to be rewritten to document using a permissions registry instead
of the deprecated, magical decorator style of usage.

PSU-OIT-ARC/django-perms,wylee/django-perms