Fix Array.exists2 XML doc examples to use equal-length arrays (#19672)

quyentho · claude · web-flow · commit de1f4006362c · 2026-05-09T16:51:18.000Z
* Fix Array.exists2 XML doc examples to use equal-length arrays

Both examples used arrays of different lengths (2 vs 3 elements),
which would cause ArgumentException at runtime. The documented
'Evaluates to false/true' results were therefore incorrect.
Fixed by using equal-length input arrays that produce the stated results:
- inputs2 = [| 1; 3 |] with inputs1 = [| 1; 2 |] evaluates to false (neither 1&gt;1 nor 2&gt;3)
- inputs2 = [| 1; 3 |] with inputs1 = [| 1; 4 |] evaluates to true (4&gt;3)

* Add release notes for Array.exists2 doc fix

Co-Authored-By: Claude Sonnet 4.6 &lt;noreply@anthropic.com&gt;

---------

Co-authored-by: Claude Sonnet 4.6 &lt;noreply@anthropic.com&gt;
diff --git a/docs/release-notes/.FSharp.Core/11.0.100.md b/docs/release-notes/.FSharp.Core/11.0.100.md
@@ -0,0 +1,3 @@
+### Fixed
+
+* Fix `Array.exists2` documentation examples to use equal-length arrays; the previous examples would throw `ArgumentException` at runtime instead of returning the documented `false`/`true` values. ([PR #19672](https://github.com/dotnet/fsharp/pull/19672))
diff --git a/src/FSharp.Core/array.fsi b/src/FSharp.Core/array.fsi
@@ -840,7 +840,7 @@ module Array =
     /// <example id="exists2-1">
     /// <code lang="fsharp">
     /// let inputs1 = [| 1; 2 |]
-    /// let inputs2 = [| 1; 2; 0 |]
+    /// let inputs2 = [| 1; 3 |]
     ///
     /// (inputs1, inputs2) ||> Array.exists2 (fun a b -> a > b)
     /// </code>
@@ -850,7 +850,7 @@ module Array =
     /// <example id="exists2-2">
     /// <code lang="fsharp">
     /// let inputs1 = [| 1; 4 |]
-    /// let inputs2 = [| 1; 3; 5 |]
+    /// let inputs2 = [| 1; 3 |]
     ///
     /// (inputs1, inputs2) ||> Array.exists2 (fun a b -> a > b)
     /// </code>

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+### Fixed`
	`2`	`+`
	`3`	+* Fix `Array.exists2` documentation examples to use equal-length arrays; the previous examples would throw `ArgumentException` at runtime instead of returning the documented `false`/`true` values. ([PR #19672](https://github.com/dotnet/fsharp/pull/19672))