diff --git a/railties/lib/rails.rb b/railties/lib/rails.rb
index d7e22cc83949b70ff9272e0147da42ff9a3950dc..dd51a6fb014eb1c8400f7a49acc0c63589990c1e 100644
--- a/railties/lib/rails.rb
+++ b/railties/lib/rails.rb
@@ -106,7 +106,7 @@ def cache=(cache)
     # * The environment variable RAILS_GROUPS;
     # * The optional envs given as argument and the hash with group dependencies;
     #
-    #   groups :assets => [:development, :test]
+    #   groups assets: [:development, :test]
     #
     #   # Returns
     #   # => [:default, :development, :assets] for Rails.env == "development"
diff --git a/railties/lib/rails/paths.rb b/railties/lib/rails/paths.rb
index 9826aecb547edac74a875aacd166d7d536ae8c5f..acd9b71b55e9c513def20ba3767abf1d1f387537 100644
--- a/railties/lib/rails/paths.rb
+++ b/railties/lib/rails/paths.rb
@@ -5,7 +5,7 @@ module Paths
     # paths by a Hash like API. It requires you to give a physical path on initialization.
     #
     #   root = Root.new "/rails"
-    #   root.add "app/controllers", :eager_load => true
+    #   root.add "app/controllers", eager_load: true
     #
     # The command above creates a new root object and add "app/controllers" as a path.
     # This means we can get a <tt>Rails::Paths::Path</tt> object back like below:
@@ -26,7 +26,7 @@ module Paths
     # contains the path with the same path value given to +add+. In some situations,
     # you may not want this behavior, so you can give :with as option.
     #
-    #   root.add "config/routes", :with => "config/routes.rb"
+    #   root.add "config/routes", with: "config/routes.rb"
     #   root["config/routes"].inspect # => ["config/routes.rb"]
     #
     # The +add+ method accepts the following options as arguments: