chef

https://github.com/opscode/chef

Ruby

A systems integration framework, built to bring the benefits of configuration management to your entire infrastructure.

Chef::Provider::Package::Rubygems::GemEnvironment#candidate_version_from_remote

Finds the newest version that satisfies the constraints of
+gem_dependency+. The version is determined from the cache or a
round-trip to the server as needed. The architecture and gem
sources will be set before making the query.
=== Returns
Gem::Version  a singular gem version object is returned if the gem
              is available
nil           returns nil if the gem could not be found

Source | Google | Stack overflow

Edit

git clone [email protected]:opscode/chef.git

cd chef

open lib/chef/provider/package/rubygems.rb

Contribute

# Make a new branch

git checkout -b -your-name--update-docs-Chef--Provider--Package--Rubygems--GemEnvironment-candidate_version_from_remote-for-pr

# Commit to git

git add lib/chef/provider/package/rubygems.rbgit commit -m "better docs for Chef::Provider::Package::Rubygems::GemEnvironment#candidate_version_from_remote"

# Open pull request

gem install hub # on a mac you can `brew install hub`

hub fork

git push <your name> -your-name--update-docs-Chef--Provider--Package--Rubygems--GemEnvironment-candidate_version_from_remote-for-pr

hub pull-request

# Celebrate!