Merge pull request rails#53029 from jgsheppa/52852_nulls_not_distinct…

…_documentation

Add documentation for `nulls_not_distinct` option to `add_index` [ci skip]

activerecord/lib/active_record/connection_adapters/abstract/schema_statements.rb

@@ -855,6 +855,16 @@ def rename_column(table_name, column_name, new_column_name)
       #
       # Note: only supported by PostgreSQL.
       #
+      # ====== Creating an index where NULLs are treated equally
+      #
+      #   add_index(:people, :last_name, nulls_not_distinct: true)
+      #
+      # generates:
+      #
+      #   CREATE INDEX index_people_on_last_name ON people (last_name) NULLS NOT DISTINCT
+      #
+      # Note: only supported by PostgreSQL version 15.0.0 and greater.
+      #
       # ====== Creating an index with a specific method
       #
       #   add_index(:developers, :name, using: 'btree')