Improve and normalize method documentation

Author: emmadesilva

packages/framework/src/Foundation/Kernel/Hyperlinks.php

@@ -103,10 +103,10 @@ public function mediaLink(string $destination, bool $validate = false): string
     }
 
     /**
-     * Gets a relative web link to the given image stored in the _site/media folder.
-     * If the image is remote (starts with http) it will be returned as is.
+     * Gets a relative web link to the given file stored in the `_site/media` folder.
+     * If the image is already qualified (starts with `http`) it will be returned as is.
      *
-     * If a base URL is set, the image will be returned with a qualified absolute URL.
+     * If a base URL is configured, the image will be returned with a qualified absolute URL.
      */
     public function asset(string $name): string
     {

packages/framework/src/helpers.php

@@ -20,7 +20,10 @@ function hyde(): HydeKernel
     } else {
         if (! function_exists('asset')) {
             /**
-             * Get a relative link or URL to an asset in the media directory.
+             * Gets a relative web link to the given file stored in the `_site/media` folder.
+             * If the image is already qualified (starts with `http`) it will be returned as is.
+             *
+             * If a base URL is configured, the image will be returned with a qualified absolute URL.
              */
             function asset(string $name): string
             {