docs: Clarify exception documentation and improve type inference descriptions in test cases. (#57)

Author: terabytesoftw

CHANGELOG.md

@@ -24,6 +24,7 @@
 - Bug #54: Update `PHPStan` `tmpDir` config; move `runtime` directory to `root`; update docs (@terabytesoftw)
 - Bug #55: Remove `OS` and `PHP` version specifications from workflow files for simplification (@terabytesoftw)
 - Enh #56: Add `ServiceLocatorDynamicMethodReturnTypeExtension` to provide precise type inference for `get()` method (@terabytesoftw)
+- Bug #57: Clarify exception documentation and improve type inference descriptions in test cases (@terabytesoftw)
 
 ## 0.2.3 June 09, 2025
 

tests/data/type/ActiveQueryDynamicMethodReturnType.php

@@ -109,7 +109,7 @@ public function testReturnMyActiveRecordArrayWhenObjectsWithCondition(): void
     }
 
     /**
-     * @throws Exception
+     * @throws Exception if an unexpected error occurs during execution.
      */
     public function testReturnMyActiveRecordOrNullWhenChainedWithOne(): void
     {

tests/type/ContainerDynamicMethodReturnTypeExtensionTest.php

@@ -16,14 +16,14 @@
  * access.
  *
  * The test class loads type assertions from a fixture file and delegates checks to the parent
- * {@see TypeInferenceTestCase}, ensuring that extension logic for container dynamic method return types is robust and
- * consistent with expected behavior.
+ * {@see TypeInferenceTestCase}, ensuring that extension logic for {@see Container} dynamic method return types is
+ * robust and consistent with expected behavior.
  *
  * Key features.
- * - Ensures compatibility with PHPStan extension configuration for container dynamic return types.
+ * - Ensures compatibility with PHPStan extension configuration.
  * - Loads and executes type assertions from a dedicated fixture file.
  * - Uses PHPUnit DataProvider for parameterized test execution.
- * - Validates type inference for dynamic service resolution and property access.
+ * - Validates type inference for chained query methods and result types.
  *
  * @copyright Copyright (C) 2023 Terabytesoftw.
  * @license https://opensource.org/license/bsd-3-clause BSD 3-Clause License.