[12.x] document change in Eloquent Collection partition behavior

collections.md

@@ -1713,6 +1713,9 @@ The `partition` method may be combined with PHP array destructuring to separate
 
     // [3, 4, 5, 6]
 
+> [!NOTE]
+> This method's behavior is modified when using [Eloquent Collections](/docs/{{version}}/eloquent-collections#method-partition).
+
 <a name="method-percentage"></a>
 #### `percentage()` {.collection-method}
 

eloquent-collections.md

@@ -75,6 +75,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)
@@ -195,6 +196,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 a base Collection of Eloquent Collections:
+
+```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}