Add helpful comments to site template _config.yml
No longer set "permalink: pretty" in the _config.yml for the site template

This causes unintuitive behaviour that doesn’t align with the
documentation.

Fixes #2399.
Merge pull request #2680 from jekyll/no-pretty