Ruby on Rails Gems
Remarks
Gemfile documentation
For projects that are expected to grow, it is a good idea add comments your Gemfile. That way, even in large setups you will still know what each gem does even if the name is not self-explanatory and you added it 2 years ago.
This can also help you to remember why you chose a certain version and consequently re-evaluate the version requirement later on.
Examples:
# temporary downgrade for TeamCity gem 'rake', '~> 10.5.0' # To upload invoicing information to payment provider gem 'net-sftp' 
