Merge pull request rails#27165 from prathamesh-sonpatki/followup-uuid-extension-change

Followup of UUID default extension in the docs

Author: rafaelfranca

activerecord/lib/active_record/connection_adapters/postgresql/schema_definitions.rb

@@ -12,11 +12,21 @@ module ColumnMethods
         #   end
         #
         # By default, this will use the +gen_random_uuid()+ function from the
-        # +pgcrypto+ extension (only PostgreSQL >= 9.4), or +uuid_generate_v4()+
-        # function from the +uuid-ossp+ extension. To enable the appropriate
-        # extension, which is a requirement, you can use the +enable_extension+
-        # method in your migrations. To use a UUID primary key without any of
-        # of extensions, you can set the +:default+ option to +nil+:
+        # +pgcrypto+ extension. As that extension is only available in
+        # PostgreSQL 9.4+, for earlier versions an explicit default can be set
+        # to use +uuid_generate_v4()+ from the +uuid-ossp+ extension instead:
+        #
+        #   create_table :stuffs, id: false do |t|
+        #     t.primary_key :id, :uuid, default: "uuid_generate_v4()"
+        #     t.uuid :foo_id
+        #     t.timestamps
+        #   end
+        #
+        # To enable the appropriate extension, which is a requirement, use
+        # the +enable_extension+ method in your migrations.
+        #
+        # To use a UUID primary key without any of the extensions, set the
+        # +:default+ option to +nil+:
         #
         #   create_table :stuffs, id: false do |t|
         #     t.primary_key :id, :uuid, default: nil

guides/source/active_record_postgresql.md

@@ -422,7 +422,7 @@ device = Device.create
 device.id # => "814865cd-5a1d-4771-9306-4268f188fe9e"
 ```
 
-NOTE: `uuid_generate_v4()` (from `uuid-ossp`) is assumed if no `:default` option was
+NOTE: `gen_random_uuid()` (from `pgcrypto`) is assumed if no `:default` option was
 passed to `create_table`.
 
 Full Text Search