[DOC] Clarify previous (type/value) in Activecord::Attributes attribute (rails#52208)

aeroastro · rafaelfranca · p8 · web-flow · commit 25bab2febe71 · 2024-08-12T11:30:03.000-07:00
* Clarify previous (type/value) in Activecord::Attributes `attribute`

* Update activerecord/lib/active_record/attributes.rb

Co-authored-by: Petrik de Heus &lt;petrik@deheus.net&gt;

---------

Co-authored-by: Rafael Mendonça França &lt;rafael@franca.dev&gt;
Co-authored-by: Petrik de Heus &lt;petrik@deheus.net&gt;
diff --git a/activerecord/lib/active_record/attributes.rb b/activerecord/lib/active_record/attributes.rb
@@ -25,15 +25,17 @@ module ClassMethods
       # column which this will persist to.
       #
       # +cast_type+ A symbol such as +:string+ or +:integer+, or a type object
-      # to be used for this attribute. See the examples below for more
-      # information about providing custom type objects.
+      # to be used for this attribute. If this parameter is not passed, the previously
+      # defined type (if any) will be used.
+      # Otherwise, the type will be ActiveModel::Type::Value.
+      # See the examples below for more information about providing custom type objects.
       #
       # ==== Options
       #
       # The following options are accepted:
       #
       # +default+ The default value to use when no value is provided. If this option
-      # is not passed, the previous default value (if any) will be used.
+      # is not passed, the previously defined default value (if any) on the superclass or in the schema will be used.
       # Otherwise, the default will be +nil+.
       #
       # +array+ (PostgreSQL only) specifies that the type should be an array (see the

Original file line number	Diff line number	Diff line change
`@@ -25,15 +25,17 @@ module ClassMethods`
`25`	`25`	`# column which this will persist to.`
`26`	`26`	`#`
`27`	`27`	`# +cast_type+ A symbol such as +:string+ or +:integer+, or a type object`
`28`		`- # to be used for this attribute. See the examples below for more`
`29`		`- # information about providing custom type objects.`
	`28`	`+ # to be used for this attribute. If this parameter is not passed, the previously`
	`29`	`+ # defined type (if any) will be used.`
	`30`	`+ # Otherwise, the type will be ActiveModel::Type::Value.`
	`31`	`+ # See the examples below for more information about providing custom type objects.`
`30`	`32`	`#`
`31`	`33`	`# ==== Options`
`32`	`34`	`#`
`33`	`35`	`# The following options are accepted:`
`34`	`36`	`#`
`35`	`37`	`# +default+ The default value to use when no value is provided. If this option`
`36`		`- # is not passed, the previous default value (if any) will be used.`
	`38`	`+ # is not passed, the previously defined default value (if any) on the superclass or in the schema will be used.`
`37`	`39`	`# Otherwise, the default will be +nil+.`
`38`	`40`	`#`
`39`	`41`	`# +array+ (PostgreSQL only) specifies that the type should be an array (see the`