Update docs

Author: coisa

.docheader

@@ -7,4 +7,5 @@
  * @link      https://github.com/php-fast-forward/container
  * @copyright Copyright (c) 2025-%year% Felipe Sayão Lobato Abreu <[email protected]>
  * @license   https://opensource.org/licenses/MIT MIT License
+ * @see       https://datatracker.ietf.org/doc/html/rfc2119
  */

.github/workflows/tests.yml

@@ -70,6 +70,7 @@ jobs:
               uses: phpDocumentor/[email protected]
               with:
                 target: 'public/'
+                template: 'responsive-twig'
 
             - name: Upload artifact
               if: github.ref == 'refs/heads/main'

.php-cs-fixer.php

@@ -11,6 +11,7 @@
  * @link      https://github.com/php-fast-forward/container
  * @copyright Copyright (c) 2025 Felipe Sayão Lobato Abreu <[email protected]>
  * @license   https://opensource.org/licenses/MIT MIT License
+ * @see       https://datatracker.ietf.org/doc/html/rfc2119
  */
 
 use CoiSA\PhpCsFixer\PhpCsFixer;

composer.json

@@ -53,9 +53,9 @@
         }
     },
     "scripts": {
-        "cs-check": "php-cs-fixer fix --dry-run --diff",
-        "cs-fix": "php-cs-fixer fix",
-        "docs": "phpdoc",
+        "cs-check": "PHP_CS_FIXER_IGNORE_ENV=1 php-cs-fixer fix --dry-run --diff",
+        "cs-fix": "PHP_CS_FIXER_IGNORE_ENV=1 php-cs-fixer fix",
+        "docs": "vendor/bin/phpdoc.phar",
         "mutation-testing": "infection --threads=4",
         "pre-commit": [
             "@cs-check",

src/AggregateContainer.php

@@ -11,6 +11,7 @@
  * @link      https://github.com/php-fast-forward/container
  * @copyright Copyright (c) 2025 Felipe Sayão Lobato Abreu <[email protected]>
  * @license   https://opensource.org/licenses/MIT MIT License
+ * @see       https://datatracker.ietf.org/doc/html/rfc2119
  */
 
 namespace FastForward\Container;
@@ -21,15 +22,12 @@
 use Psr\Container\NotFoundExceptionInterface;
 
 /**
- * Class AggregateContainer.
- *
  * Aggregates multiple PSR-11 containers and delegates resolution requests among them.
- * This container implementation MUST respect PSR-11 expectations and SHALL throw a
- * NotFoundException when a requested service cannot be found in any delegated container.
  *
- * It MAY cache resolved entries to prevent redundant calls to delegated containers.
+ * This container implementation respects PSR-11 expectations and throws a
+ * NotFoundException when a requested service cannot be found in any delegated container.
  *
- * @package FastForward\Container
+ * It caches resolved entries to prevent redundant calls to delegated containers.
  */
 class AggregateContainer implements ContainerInterface
 {
@@ -168,7 +166,7 @@ public function get(string $id): mixed
     /**
      * Determines whether the identifier has already been resolved by this container.
      *
-     * This method SHALL be used internally to avoid unnecessary delegation to sub-containers.
+     * This method is used internally to avoid unnecessary delegation to sub-containers.
      *
      * @param string $id the identifier to check
      *

src/AutowireContainer.php

@@ -11,6 +11,7 @@
  * @link      https://github.com/php-fast-forward/container
  * @copyright Copyright (c) 2025 Felipe Sayão Lobato Abreu <[email protected]>
  * @license   https://opensource.org/licenses/MIT MIT License
+ * @see       https://datatracker.ietf.org/doc/html/rfc2119
  */
 
 namespace FastForward\Container;
@@ -21,11 +22,11 @@
 use Psr\Container\NotFoundExceptionInterface;
 
 /**
- * Class AutowireContainer.
- *
  * A composite container implementation that wraps another PSR-11 container and appends
- * an internal PHP-DI autowiring container. It provides auto-resolution of services
- * while maintaining compatibility with pre-defined service providers.
+ * an internal PHP-DI autowiring container.
+ *
+ * It provides auto-resolution of services while maintaining compatibility with
+ * pre-defined service providers.
  *
  * This container MUST be used in scenarios where automatic dependency resolution
  * via autowiring is required alongside explicitly registered services.
@@ -73,16 +74,6 @@ public function get(string $id): mixed
         return $this->container->get($id);
     }
 
-    /**
-     * Determines whether the container can return an entry for the given identifier.
-     *
-     * This method attempts to resolve the entry to confirm that it is not only registered,
-     * but also valid and free of runtime errors during instantiation.
-     *
-     * @param string $id identifier of the entry to check
-     *
-     * @return bool true if the container can return the entry, false otherwise
-     */
     public function has(string $id): bool
     {
         if (!$this->container->has($id)) {

src/ContainerInterface.php

@@ -11,18 +11,19 @@
  * @link      https://github.com/php-fast-forward/container
  * @copyright Copyright (c) 2025 Felipe Sayão Lobato Abreu <[email protected]>
  * @license   https://opensource.org/licenses/MIT MIT License
+ * @see       https://datatracker.ietf.org/doc/html/rfc2119
  */
 
 namespace FastForward\Container;
 
 use Psr\Container\ContainerInterface as PsrContainerInterface;
 
 /**
- * Interface ContainerInterface
- *
  * Extends the PSR-11 ContainerInterface to provide a consistent, domain-specific container interface
- * for the FastForward ecosystem. This interface SHALL serve as the preferred type hint within FastForward
- * components, while maintaining full compatibility with PSR-11 standards.
+ * for the FastForward ecosystem.
+ *
+ * This interface SHALL serve as the preferred type hint within FastForward components, while maintaining
+ * full compatibility with PSR-11 standards.
  *
  * Implementations of this interface MUST adhere to the behavior defined by PSR-11, specifically:
  *

src/Exception/ContainerException.php

@@ -11,16 +11,16 @@
  * @link      https://github.com/php-fast-forward/container
  * @copyright Copyright (c) 2025 Felipe Sayão Lobato Abreu <[email protected]>
  * @license   https://opensource.org/licenses/MIT MIT License
+ * @see       https://datatracker.ietf.org/doc/html/rfc2119
  */
 
 namespace FastForward\Container\Exception;
 
 use Psr\Container\ContainerExceptionInterface;
 
 /**
- * Class ContainerException.
+ * Exception type for container-related errors while resolving services.
  *
- * Exception type for container-related errors in the event dispatcher.
  * This class MUST be used to signal problems occurring during service resolution
  * from a container that complies with PSR-11.
  *

src/Exception/InvalidArgumentException.php

@@ -11,15 +11,16 @@
  * @link      https://github.com/php-fast-forward/container
  * @copyright Copyright (c) 2025 Felipe Sayão Lobato Abreu <[email protected]>
  * @license   https://opensource.org/licenses/MIT MIT License
+ * @see       https://datatracker.ietf.org/doc/html/rfc2119
  */
 
 namespace FastForward\Container\Exception;
 
 /**
- * Class InvalidArgumentException.
+ * Exception thrown when an invalid or unsupported argument is passed to a function or method within the container.
  *
- * Exception thrown when an argument passed to a function or method is invalid or unsupported.
- * This exception MUST be used when a container initializer does not match any of the allowed types.
+ * This exception helps identify and handle errors related to invalid or unrecognized arguments,
+ * especially when an unsupported initializer type is provided to the container builder.
  *
  * @package FastForward\Container\Exception
  */

src/Exception/NotFoundException.php

@@ -11,15 +11,14 @@
  * @link      https://github.com/php-fast-forward/container
  * @copyright Copyright (c) 2025 Felipe Sayão Lobato Abreu <[email protected]>
  * @license   https://opensource.org/licenses/MIT MIT License
+ * @see       https://datatracker.ietf.org/doc/html/rfc2119
  */
 
 namespace FastForward\Container\Exception;
 
 use Psr\Container\NotFoundExceptionInterface;
 
 /**
- * Class NotFoundException.
- *
  * Exception thrown when a requested service identifier is not found in the container.
  *
  * This class MUST be used in PSR-11 container implementations to represent an error