Improve comments, so they better describe why you should or should not declare gems here

I think the previous wording was ambiguous, and didn't really explain why gems should be declared in the gemspec rather than here.

[ci skip]
Adds [ci skip]

Merge branch 'improve_comments_in_engine_gemfile_template' of https://github.com/reggieb/rails into improve_comments_in_engine_gemfile_template