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#converge_if_changed

Handle patchy convergence safely.

- Does *not* call the block if the current_resource's properties match
  the properties the user specified on the resource.
- Calls the block if current_resource does not exist
- Calls the block if the user has specified any properties in the resource
  whose values are *different* from current_resource.
- Does *not* call the block if why-run is enabled (just prints out text).
- Prints out automatic green text saying what properties have changed.

Source | Google | Stack overflow

Edit

git clone [email protected]:opscode/chef.git
cd chef
open lib/chef/provider.rb

Contribute

# Make a new branch

git checkout -b -your-name--update-docs-Chef--Provider-converge_if_changed-for-pr

# Commit to git

git add lib/chef/provider.rbgit commit -m "better docs for Chef::Provider#converge_if_changed"

# 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-converge_if_changed-for-pr

hub pull-request

# Celebrate!