Add docs for Active Record validation with multiple contexts

notapatch · notapatch · commit 5b2537543477 · 2023-04-06T16:13:38.000+01:00
The PR documents this change: rails#21535 Which allows multiple contexts to be validated: person.valid?([:create, :update]) # => true The change isn't visible in the API documentation which this PR fixes.
diff --git a/activerecord/lib/active_record/validations.rb b/activerecord/lib/active_record/validations.rb
@@ -62,6 +62,8 @@ def save!(**options)
     #
     # If the argument is +false+ (default is +nil+), the context is set to <tt>:create</tt> if
     # {new_record?}[rdoc-ref:Persistence#new_record?] is +true+, and to <tt>:update</tt> if it is not.
+    # If the argument is an array of contexts, <tt>post.valid?([:create, :update])</tt>, the validations are
+    # run within multiple contexts.
     #
     # \Validations with no <tt>:on</tt> option will run no matter the context. \Validations with
     # some <tt>:on</tt> option will only run in the specified context.

Original file line number	Diff line number	Diff line change
`@@ -62,6 +62,8 @@ def save!(**options)`
`62`	`62`	`#`
`63`	`63`	`# If the argument is +false+ (default is +nil+), the context is set to <tt>:create</tt> if`
`64`	`64`	`# {new_record?}[rdoc-ref:Persistence#new_record?] is +true+, and to <tt>:update</tt> if it is not.`
	`65`	`+ # If the argument is an array of contexts, <tt>post.valid?([:create, :update])</tt>, the validations are`
	`66`	`+ # run within multiple contexts.`
`65`	`67`	`#`
`66`	`68`	`# \Validations with no <tt>:on</tt> option will run no matter the context. \Validations with`
`67`	`69`	`# some <tt>:on</tt> option will only run in the specified context.`