docs: rephrase comments to be more descriptive and natural

Author: bhardwajparth51

src/Utopia/Messaging/Adapter/SMS/VonageMessages.php

@@ -9,10 +9,10 @@
 /**
  * Vonage Messages API SMS Adapter.
  *
- * Uses the newer Vonage Messages API (V1) instead of the older SMS API.
- * The Messages API is cheaper and supports multiple message types.
+ * This adapter uses the modern Vonage Messages API (V1) which is more cost-effective
+ * and versatile than the legacy SMS API.
  *
- * Reference: https://developer.vonage.com/en/api/messages
+ * @link https://developer.vonage.com/en/api/messages
  */
 class VonageMessages extends SMSAdapter
 {
@@ -30,23 +30,23 @@ public function __construct(
     }
 
     /**
-     * Get the API endpoint for the Vonage Messages API.
+     * Vonage Messages API endpoint.
      */
     protected function getApiEndpoint(): string
     {
         return 'https://api.vonage.com/v1/messages';
     }
 
     /**
-     * Get the authorization header value for the API request.
+     * Generates the Basic Authorization header.
      */
     protected function getAuthorizationHeader(): string
     {
         return 'Basic ' . \base64_encode("{$this->apiKey}:{$this->apiSecret}");
     }
 
     /**
-     * Build the request headers for the Messages API.
+     * Sets common headers for the API request.
      *
      * @return array<string>
      */

tests/Messaging/Adapter/SMS/VonageMessagesTest.php

@@ -9,6 +9,8 @@
 class VonageMessagesTest extends Base
 {
     /**
+     * Tests sending an SMS with the 'from' number set directly in the adapter.
+     *
      * @throws \Exception
      */
     public function testSendSMS(): void
@@ -38,6 +40,8 @@ public function testSendSMS(): void
     }
 
     /**
+     * Tests sending an SMS where the 'from' number is provided by the message object.
+     *
      * @throws \Exception
      */
     public function testSendSMSWithFallbackFrom(): void