use promoted properties (#8536)

using promoted properties makes the docs more succinct.

I did not switch to promoted properties when the properties were not explicitly defined in the code already.

Author: browner12

blade.md

@@ -735,28 +735,13 @@ You should define all of the component's data attributes in its class constructo
 
     class Alert extends Component
     {
-        /**
-         * The alert type.
-         *
-         * @var string
-         */
-        public $type;
-
-        /**
-         * The alert message.
-         *
-         * @var string
-         */
-        public $message;
-
         /**
          * Create the component instance.
          */
-        public function __construct(string $type, string $message)
-        {
-            $this->type = $type;
-            $this->message = $message;
-        }
+        public function __construct(
+            public string $type,
+            public string $message,
+        ) {}
 
         /**
          * Get the view / contents that represent the component.

broadcasting.md

@@ -375,20 +375,12 @@ The `ShouldBroadcast` interface requires you to implement a single method: `broa
     {
         use SerializesModels;
 
-        /**
-         * The user that created the server.
-         *
-         * @var \App\Models\User
-         */
-        public $user;
-
         /**
          * Create a new event instance.
          */
-        public function __construct(User $user)
-        {
-            $this->user = $user;
-        }
+        public function __construct(
+            public User $user,
+        ) {}
 
         /**
          * Get the channels the event should broadcast on.

collections.md

@@ -1655,18 +1655,12 @@ The `pipeInto` method creates a new instance of the given class and passes the c
 
     class ResourceCollection
     {
-        /**
-         * The Collection instance.
-         */
-        public $collection;
-
         /**
          * Create a new ResourceCollection instance.
          */
-        public function __construct(Collection $collection)
-        {
-            $this->collection = $collection;
-        }
+        public function __construct(
+          public Collection $collection,
+        ) {}
     }
 
     $collection = collect([1, 2, 3]);

container.md

@@ -36,20 +36,12 @@ Let's look at a simple example:
 
     class UserController extends Controller
     {
-        /**
-         * The user repository implementation.
-         *
-         * @var UserRepository
-         */
-        protected $users;
-
         /**
          * Create a new controller instance.
          */
-        public function __construct(UserRepository $users)
-        {
-            $this->users = $users;
-        }
+        public function __construct(
+            protected UserRepository $users,
+        ) {}
 
         /**
          * Show the profile for the given user.
@@ -395,20 +387,12 @@ For example, you may type-hint a repository defined by your application in a con
 
     class UserController extends Controller
     {
-        /**
-         * The user repository instance.
-         *
-         * @var \App\Repositories\UserRepository
-         */
-        protected $users;
-
         /**
          * Create a new controller instance.
          */
-        public function __construct(UserRepository $users)
-        {
-            $this->users = $users;
-        }
+        public function __construct(
+            protected UserRepository $users,
+        ) {}
 
         /**
          * Show the user with the given ID.

contracts.md

@@ -48,20 +48,12 @@ For example, take a look at this event listener:
 
     class CacheOrderInformation
     {
-        /**
-         * The Redis factory implementation.
-         *
-         * @var \Illuminate\Contracts\Redis\Factory
-         */
-        protected $redis;
-
         /**
          * Create a new event handler instance.
          */
-        public function __construct(Factory $redis)
-        {
-            $this->redis = $redis;
-        }
+        public function __construct(
+            protected Factory $redis,
+        ) {}
 
         /**
          * Handle the event.

controllers.md

@@ -465,18 +465,12 @@ The Laravel [service container](/docs/{{version}}/container) is used to resolve
 
     class UserController extends Controller
     {
-        /**
-         * The user repository instance.
-         */
-        protected $users;
-
         /**
          * Create a new controller instance.
          */
-        public function __construct(UserRepository $users)
-        {
-            $this->users = $users;
-        }
+        public function __construct(
+            protected UserRepository $users,
+        ) {}
     }
 
 <a name="method-injection"></a>

eloquent-mutators.md

@@ -654,20 +654,12 @@ A classic example of an inbound only cast is a "hashing" cast. For example, we m
 
     class Hash implements CastsInboundAttributes
     {
-        /**
-         * The hashing algorithm.
-         *
-         * @var string
-         */
-        protected $algorithm;
-
         /**
          * Create a new cast class instance.
          */
-        public function __construct(string $algorithm = null)
-        {
-            $this->algorithm = $algorithm;
-        }
+        public function __construct(
+            protected string $algorithm = null,
+        ) {}
 
         /**
          * Prepare the given value for storage.

events.md

@@ -200,20 +200,12 @@ An event class is essentially a data container which holds the information relat
     {
         use Dispatchable, InteractsWithSockets, SerializesModels;
 
-        /**
-         * The order instance.
-         *
-         * @var \App\Models\Order
-         */
-        public $order;
-
         /**
          * Create a new event instance.
          */
-        public function __construct(Order $order)
-        {
-            $this->order = $order;
-        }
+        public function __construct(
+            public Order $order,
+        ) {}
     }
 
 As you can see, this event class contains no logic. It is a container for the `App\Models\Order` instance that was purchased. The `SerializesModels` trait used by the event will gracefully serialize any Eloquent models if the event object is serialized using PHP's `serialize` function, such as when utilizing [queued listeners](#queued-event-listeners).

horizon.md

@@ -304,20 +304,12 @@ Horizon allows you to assign “tags” to jobs, including mailables, broadcast
     {
         use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
 
-        /**
-         * The video instance.
-         *
-         * @var \App\Models\Video
-         */
-        public $video;
-
         /**
          * Create a new job instance.
          */
-        public function __construct(Video $video)
-        {
-            $this->video = $video;
-        }
+        public function __construct(
+            public Video $video,
+        ) {}
 
         /**
          * Execute the job.

mail.md

@@ -281,20 +281,12 @@ Typically, you will want to pass some data to your view that you can utilize whe
     {
         use Queueable, SerializesModels;
 
-        /**
-         * The order instance.
-         *
-         * @var \App\Models\Order
-         */
-        public $order;
-
         /**
          * Create a new message instance.
          */
-        public function __construct(Order $order)
-        {
-            $this->order = $order;
-        }
+        public function __construct(
+            public Order $order,
+        ) {}
 
         /**
          * Get the message content definition.
@@ -332,20 +324,12 @@ If you would like to customize the format of your email's data before it is sent
     {
         use Queueable, SerializesModels;
 
-        /**
-         * The order instance.
-         *
-         * @var \App\Models\Order
-         */
-        protected $order;
-
         /**
          * Create a new message instance.
          */
-        public function __construct(Order $order)
-        {
-            $this->order = $order;
-        }
+        public function __construct(
+            protected Order $order,
+        ) {}
 
         /**
          * Get the message content definition.
@@ -1059,21 +1043,13 @@ Laravel includes a variety of mail transports; however, you may wish to write yo
 
     class MailchimpTransport extends AbstractTransport
     {
-        /**
-         * The Mailchimp API client.
-         *
-         * @var \MailchimpTransactional\ApiClient
-         */
-        protected $client;
-
         /**
          * Create a new Mailchimp transport instance.
          */
-        public function __construct(ApiClient $client)
-        {
+        public function __construct(
+            protected ApiClient $client,
+        ) {
             parent::__construct();
-            
-            $this->client = $client;
         }
 
         /**