Per Django 1.5, permalink decorator no longer recommended.
Changed links from markdown syntax to rst.
Merge pull request #12 from kkumler/master

Remove recommendation for permalink