Added some docblock comments.

Author: ariddlestone

src/ControllerComponentsExtension.php

@@ -10,7 +10,7 @@
 use PHPStan\Reflection\ReflectionProvider;
 
 /**
- * Supports discovering models in controllers.
+ * Adds {@link Component}s as properties to {@link Controller}s.
  */
 final class ControllerComponentsExtension implements
     PropertiesClassReflectionExtension

src/ControllerModelsExtension.php

@@ -10,7 +10,7 @@
 use PHPStan\Reflection\ReflectionProvider;
 
 /**
- * Supports discovering models in controllers.
+ * Adds {@link Model}s as properties to {@link Controller}s.
  */
 final class ControllerModelsExtension implements
     PropertiesClassReflectionExtension

src/ModelBehaviorMethodWrapper.php

@@ -12,6 +12,10 @@
 use PHPStan\TrinaryLogic;
 use PHPStan\Type\Type;
 
+/**
+ * Wraps {@link ModelBehavior} {@link MethodReflection}s to remove their first
+ * parameter (which should be the {@link Model}).
+ */
 final class ModelBehaviorMethodWrapper implements MethodReflection
 {
     /**

src/ModelBehaviorsExtension.php

@@ -15,6 +15,9 @@
 use PHPStan\Reflection\ReflectionProvider;
 use PHPStan\Type\ObjectType;
 
+/**
+ * Adds methods to {@link Model}s from {@link ModelBehavior} classes.
+ */
 final class ModelBehaviorsExtension implements MethodsClassReflectionExtension
 {
     /**
@@ -79,6 +82,8 @@ static function (
     }
 
     /**
+     * Gets all behavior methods from known behavior classes.
+     *
      * @return array<MethodReflection>
      *
      * @throws Exception
@@ -127,6 +132,15 @@ private function getModelBehaviorMethods(
         return array_map([$this, 'wrapBehaviorMethod'], $methodReflections);
     }
 
+    /**
+     * Returns true if the given method would be made available as a behavior
+     * method.
+     *
+     * Specifically it must meet the following conditions:
+     * * Be public
+     * * Not be static
+     * * Have at least one variant which accepts a Model as its first parameter
+     */
     private function filterBehaviorMethods(
         ExtendedMethodReflection $methodReflection
     ): bool {
@@ -138,6 +152,10 @@ private function filterBehaviorMethods(
             );
     }
 
+    /**
+     * Returns true if the given method variant accepts a Model as its first
+     * parameter.
+     */
     private function filterBehaviorMethodVariants(
         ParametersAcceptor $parametersAcceptor
     ): bool {
@@ -160,13 +178,18 @@ private function filterBehaviorMethodVariants(
         return true;
     }
 
+    /**
+     * Wraps a method reflection in a wrapper which removes the first parameter.
+     */
     private function wrapBehaviorMethod(
         MethodReflection $methodReflection
     ): MethodReflection {
         return new ModelBehaviorMethodWrapper($methodReflection);
     }
 
     /**
+     * Returns the name of a method from its reflection.
+     *
      * @param MethodReflection|ReflectionMethod $methodReflection
      */
     private function getMethodReflectionName($methodReflection): string