Update docs for pop() and shift() (#7205)

* Update docs for pop() and shift() to include option to pass integer to retrieve multiple items

* Update collections.md

* Update collections.md

Co-authored-by: Taylor Otwell <[email protected]>

Author: edgrosvenor

collections.md

@@ -1605,6 +1605,18 @@ The `pop` method removes and returns the last item from the collection:
 
     // [1, 2, 3, 4]
 
+You may pass an integer to the `pop` method to remove and return multiple items from the end of a collection:
+
+    $collection = collect([1, 2, 3, 4, 5]);
+
+    $collection->pop(3);
+
+    // collect([5, 4, 3])
+
+    $collection->all();
+
+    // [1, 2]
+
 <a name="method-prepend"></a>
 #### `prepend()` {#collection-method}
 
@@ -1846,6 +1858,18 @@ The `shift` method removes and returns the first item from the collection:
 
     // [2, 3, 4, 5]
 
+You may pass an integer to the `shift` method to remove and return multiple items from the beginning of a collection:
+
+    $collection = collect([1, 2, 3, 4, 5]);
+
+    $collection->shift(3);
+
+    // collect([1, 2, 3])
+
+    $collection->all();
+
+    // [4, 5]
+
 <a name="method-shuffle"></a>
 #### `shuffle()` {#collection-method}