Merge branch '5.5' of github.com:laravel/docs into 5.5

Author: taylorotwell

collections.md

@@ -1359,6 +1359,8 @@ You may optionally pass an integer to `random` to specify how many items you wou
 
     // [2, 4, 5] - (retrieved randomly)
 
+If the Collection has fewer items than requested, the method will throw an `InvalidArgumentException`.
+
 <a name="method-reduce"></a>
 #### `reduce()` {#collection-method}
 

dusk.md

@@ -46,7 +46,7 @@ Laravel Dusk provides an expressive, easy-to-use browser automation and testing
 
 To get started, you should add the `laravel/dusk` Composer dependency to your project:
 
-    composer require --dev laravel/dusk:^2.0
+    composer require --dev laravel/dusk:"^2.0"
 
 Once Dusk is installed, you should register the `Laravel\Dusk\DuskServiceProvider` service provider. Typically, this will be done automatically via Laravel's automatic service provider registration.
 

helpers.md

@@ -1477,7 +1477,7 @@ The `tap` function accepts two arguments: an arbitrary `$value` and a Closure. T
         $user->save();
     });
 
-If no Closure is passed to the `tap` function, you may call any method on the given `$value`. The return value of the method you call will always be `$value`, regardless of the what the method actually returns in its definition. For example, the Eloquent `update` method typically returns an integer. However, we can force the method to return the model itself by chaining the `update` method call through the `tap` function:
+If no Closure is passed to the `tap` function, you may call any method on the given `$value`. The return value of the method you call will always be `$value`, regardless of what the method actually returns in its definition. For example, the Eloquent `update` method typically returns an integer. However, we can force the method to return the model itself by chaining the `update` method call through the `tap` function:
 
     $user = tap($user)->update([
         'name' => $name,

http-tests.md

@@ -393,7 +393,7 @@ Assert that the session contains the given piece of data:
 
 Assert that the session has a given list of values:
 
-    $response->assertSessionHasAll($key, $value = null);
+    $response->assertSessionHasAll(array $data);
 
 <a name="assert-session-has-errors"></a>
 #### assertSessionHasErrors

passport.md

@@ -42,7 +42,7 @@ Laravel already makes it easy to perform authentication via traditional login fo
 
 To get started, install Passport via the Composer package manager:
 
-    composer require laravel/passport
+    composer require laravel/passport=~4.0
 
 The Passport service provider registers its own database migration directory with the framework, so you should migrate your database after registering the provider. The Passport migrations will create the tables your application needs to store clients and access tokens:
 

routing.md

@@ -317,7 +317,7 @@ To register an explicit binding, use the router's `model` method to specify the
 
 Next, define a route that contains a `{user}` parameter:
 
-    Route::get('profile/{user}', function (App\User $user) {
+    Route::get('profile/{user}', function ($user) {
         //
     });
 

upgrade.md

@@ -52,6 +52,8 @@ Update your `laravel/framework` dependency to `5.5.*` in your `composer.json` fi
         ],
     }
 
+If you are using the `laravel/browser-kit-testing` package, you should update the package to `2.*` in your `composer.json` file.
+
 Of course, don't forget to examine any 3rd party packages consumed by your application and verify you are using the proper version for Laravel 5.5 support.
 
 #### Laravel Installer