Merge pull request rails#50994 from p8/activerecord/document-alias-attribute

Document ActiveRecord `alias_attribute` [ci-skip]

Author: p8

activerecord/lib/active_record/attribute_methods.rb

@@ -49,6 +49,20 @@ def initialize_generated_modules # :nodoc:
         super
       end
 
+      # Allows you to make aliases for attributes.
+      #
+      #   class Person < ActiveRecord::Base
+      #     alias_attribute :nickname, :name
+      #   end
+      #
+      #   person = Person.create(name: 'Bob')
+      #   person.name     # => "Bob"
+      #   person.nickname # => "Bob"
+      #
+      # The alias can also be used for querying:
+      #
+      #   Person.where(nickname: "Bob")
+      #   # SELECT "people".* FROM "people" WHERE "people"."name" = "Bob"
       def alias_attribute(new_name, old_name)
         super