added String#to_date documentation to Rails 4 upgrade guide

[ci skip]
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]