feat(license): enhance documentation for license generation classes and interfaces

Signed-off-by: Felipe Sayão Lobato Abreu <github@mentordosnerds.com>

Author: coisa

src/License/Reader.php

@@ -69,7 +69,7 @@ private function readData(SplFileObject $source): array
      * If it's an array with one element, extracts that element.
      * Returns null if no license is set or if multiple licenses are specified.
      *
-     * @return string|null The license string, or null if not set or unsupported.
+     * @return string|null the license string, or null if not set or unsupported
      */
     public function getLicense(): ?string
     {
@@ -85,7 +85,7 @@ public function getLicense(): ?string
     /**
      * Retrieves the package name from composer.json.
      *
-     * @return string The full package name (vendor/package), or empty string if not set.
+     * @return string the full package name (vendor/package), or empty string if not set
      */
     public function getPackageName(): string
     {
@@ -125,7 +125,7 @@ public function getAuthors(): array
      * The package name is expected in vendor/package format.
      * Returns null if no package name is set or if the package has no vendor prefix.
      *
-     * @return string|null The vendor name, or null if package has no vendor prefix.
+     * @return string|null the vendor name, or null if package has no vendor prefix
      */
     public function getVendor(): ?string
     {
@@ -147,7 +147,7 @@ public function getVendor(): ?string
     /**
      * Returns the current year for copyright notices.
      *
-     * @return int The current year as an integer.
+     * @return int the current year as an integer
      */
     public function getYear(): int
     {
@@ -162,7 +162,7 @@ public function getYear(): int
      *
      * @param array<string> $license The license array to extract from
      *
-     * @return string|null A single license string, or null if extraction is not possible.
+     * @return string|null a single license string, or null if extraction is not possible
      */
     private function extractLicense(array $license): ?string
     {

src/License/ReaderInterface.php

@@ -29,14 +29,14 @@ interface ReaderInterface
     /**
      * Retrieves the license identifier from composer.json.
      *
-     * @return string|null The license string, or null if not set or unsupported.
+     * @return string|null the license string, or null if not set or unsupported
      */
     public function getLicense(): ?string;
 
     /**
      * Retrieves the package name from composer.json.
      *
-     * @return string The full package name (vendor/package).
+     * @return string the full package name (vendor/package)
      */
     public function getPackageName(): string;
 
@@ -50,14 +50,14 @@ public function getAuthors(): array;
     /**
      * Extracts the vendor name from the package name.
      *
-     * @return string|null The vendor name, or null if package has no vendor prefix.
+     * @return string|null the vendor name, or null if package has no vendor prefix
      */
     public function getVendor(): ?string;
 
     /**
      * Returns the current year for copyright notices.
      *
-     * @return int The current year as an integer.
+     * @return int the current year as an integer
      */
     public function getYear(): int;
 }