No longer set "permalink: pretty" in the _config.yml for the site template

This causes unintuitive behaviour that doesn’t align with the documentation.

This PR also adds helpful comments.

Fixes #2399.