Use shorthand nullability typings in docblocks for better readability

Author: jnoordsij

src/app/Console/Commands/PublishBackpackMiddleware.php

@@ -33,7 +33,7 @@ protected function getStub()
     /**
      * Execute the console command.
      *
-     * @return bool|null
+     * @return ?bool
      */
     public function handle()
     {

src/app/Http/Controllers/Auth/ResetPasswordController.php

@@ -66,7 +66,7 @@ public function __construct()
      * If no token is present, display the link request form.
      *
      * @param  \Illuminate\Http\Request  $request
-     * @param  string|null  $token
+     * @param  ?string  $token
      * @return \Illuminate\Contracts\View\View
      */
     public function showResetForm(Request $request, $token = null)

src/app/Http/Middleware/CheckIfAdmin.php

@@ -22,7 +22,7 @@ class CheckIfAdmin
      * does not have a '/home' route, use something you've built for your users
      * (again - users, not admins).
      *
-     * @param  \Illuminate\Contracts\Auth\Authenticatable|null  $user
+     * @param  ?\Illuminate\Contracts\Auth\Authenticatable  $user
      * @return bool
      */
     private function checkIfUserIsAdmin($user)

src/app/Http/Middleware/ThrottlePasswordRecovery.php

@@ -13,7 +13,7 @@ class ThrottlePasswordRecovery extends ThrottleRequests
      * @param  \Illuminate\Http\Request  $request
      * @param  string  $key
      * @param  int  $maxAttempts
-     * @param  callable|null  $responseCallback
+     * @param  ?callable  $responseCallback
      * @return \Illuminate\Validation\ValidationException
      */
     protected function buildException($request, $key, $maxAttempts, $responseCallback = null)

src/app/Http/Middleware/UseBackpackAuthGuardInsteadOfDefaultAuthGuard.php

@@ -11,7 +11,7 @@ class UseBackpackAuthGuardInsteadOfDefaultAuthGuard
      *
      * @param  \Illuminate\Http\Request  $request
      * @param  \Closure  $next
-     * @param  string|null  $guard
+     * @param  ?string  $guard
      * @return mixed
      */
     public function handle($request, Closure $next, $guard = null)

src/app/Library/Auth/ResetsPasswords.php

@@ -21,7 +21,7 @@ trait ResetsPasswords
      * If no token is present, display the link request form.
      *
      * @param  \Illuminate\Http\Request  $request
-     * @param  string|null  $token
+     * @param  ?string  $token
      * @return \Illuminate\Contracts\View\View
      */
     public function showResetForm(Request $request, $token = null)

src/app/Library/CrudPanel/CrudButton.php

@@ -294,7 +294,7 @@ public function section($stack)
      * Get the end result that should be displayed to the user.
      * The HTML itself of the button.
      *
-     * @param  object|null  $entry  The eloquent Model for the current entry or null if no current entry.
+     * @param  ?object  $entry  The eloquent Model for the current entry or null if no current entry.
      * @return \Illuminate\Contracts\View\View
      */
     public function getHtml($entry = null)

src/app/Library/CrudPanel/CrudField.php

@@ -299,7 +299,7 @@ public function validationMessages(array $messages)
      * ->addMorphOption('App\Models\Model', 'label', ['data_source' => backpack_url('smt')]).
      *
      * @param  string  $key  - the morph option key, usually a \Model\Class or a string for the morphMap
-     * @param  string|null  $label  - the displayed text for this option
+     * @param  ?string  $label  - the displayed text for this option
      * @param  array  $options  - options for the corresponding morphable_id field (usually ajax options)
      * @return self
      *

src/app/Library/CrudPanel/Traits/Buttons.php

@@ -112,7 +112,7 @@ public function buttons()
     public function modifyButton($name, $modifications = null)
     {
         /**
-         * @var CrudButton|null
+         * @var ?CrudButton
          */
         $button = $this->buttons()->firstWhere('name', $name);
 
@@ -144,7 +144,7 @@ public function removeButton($name, $stack = null)
 
     /**
      * @param  array  $names  Button names
-     * @param  string|null  $stack  Optional stack name.
+     * @param  ?string  $stack  Optional stack name.
      */
     public function removeButtons($names, $stack = null)
     {

src/app/Library/CrudPanel/Traits/Create.php

@@ -99,7 +99,7 @@ public function getRelationFields($fields = [])
      *
      * @param  Model  $item  The current CRUD model.
      * @param  array  $formattedRelations  The form data.
-     * @return bool|null
+     * @return ?bool
      */
     private function createRelationsForItem($item, $formattedRelations)
     {
@@ -220,7 +220,7 @@ private function preparePivotAttributesForSave(array $attributes, BelongsToMany|
      *                                  'attribute' => 'passport',
      *                                  'values' => **THE TRICKY BIT**,
      *                                  ]
-     * @return Model|null
+     * @return ?Model
      */
     private function createUpdateOrDeleteOneToOneRelation($relation, $relationMethod, $relationDetails)
     {