Deprecate ruby methods

README.md

See https://medium.com/it-me/deprecating-methods-in-ruby-e679c45ceeef#.etzmkdgn6 on "Deprecating methods in ruby"

original.rb

class Foo
  extend Gem::Deprecate
  
  # Does some stuff the old fashioned way.
  #
  # @deprecated Please use {#the_new_thing} instead
  def old_method
    # ...
  end
  deprecate :old_method, :the_new_thing, 2016, 4
  
  # Does some stuff the cool way.
  def the_new_thing
    # ..
  end
end