[12.x] document change in Eloquent Collection partition behavior (#10344)

* document change in Eloquent Collection partition behavior

document the code change in laravel/framework#53304

* Update collections.md

* Update eloquent-collections.md

---------

Co-authored-by: Taylor Otwell <taylor@laravel.com>

Author: browner12

collections.md

@@ -2095,6 +2095,9 @@ $equalOrAboveThree->all();
 // [3, 4, 5, 6]
 ```
 
+> [!NOTE]
+> This method's behavior is modified when interacting with [Eloquent collections](/docs/{{version}}/eloquent-collections#method-partition).
+
 <a name="method-percentage"></a>
 #### `percentage()` {.collection-method}
 

eloquent-collections.md

@@ -80,6 +80,7 @@ In addition, the `Illuminate\Database\Eloquent\Collection` class provides a supe
 [makeVisible](#method-makeVisible)
 [makeHidden](#method-makeHidden)
 [only](#method-only)
+[partition](#method-partition)
 [setVisible](#method-setVisible)
 [setHidden](#method-setHidden)
 [toQuery](#method-toquery)
@@ -237,6 +238,19 @@ The `only` method returns all of the models that have the given primary keys:
 $users = $users->only([1, 2, 3]);
 ```
 
+<a name="method-partition"></a>
+#### `partition` {.collection-method}
+
+The `partition` method returns an instance of `Illuminate\Support\Collection` containing `Illuminate\Database\Eloquent\Collection` collection instances:
+
+```php
+$partition = $users->partition(fn ($user) => $user->age > 18);
+
+dump($partition::class);    // Illuminate\Support\Collection
+dump($partition[0]::class); // Illuminate\Database\Eloquent\Collection
+dump($partition[1]::class); // Illuminate\Database\Eloquent\Collection
+```
+
 <a name="method-setVisible"></a>
 #### `setVisible($attributes)` {.collection-method}