Remove redundant comments

Follow clean code principles: remove comments that explain 'what' or 'how'
(obvious from the code) and keep only comments that explain 'why' when needed.

Removed comments like:
- 'Filter out PHP core classes' (method name is clear)
- 'skip classes in the same namespace' (obvious from condition)
- 'PHP core - filtered' in tests (evident from assertion)

The code is self-documenting through clear method and variable names.

Author: claude

src/Analyzer/ClassDescriptionBuilder.php

@@ -78,7 +78,6 @@ public function addInterface(string $FQCN, int $line): self
 
     public function addDependency(ClassDependency $cd): self
     {
-        // Filter out PHP core classes
         if ($this->isPhpCoreClass($cd)) {
             return $this;
         }
@@ -175,11 +174,6 @@ public function build(): ClassDescription
         );
     }
 
-    /**
-     * Checks if a dependency is a PHP core/internal class.
-     * Uses Reflection to detect PHP built-in classes from core and extensions
-     * (e.g., DateTime, Exception, MongoDB\Driver\Manager, Swoole\Server).
-     */
     private function isPhpCoreClass(ClassDependency $dependency): bool
     {
         $fqcn = $dependency->getFQCN();
@@ -191,8 +185,6 @@ private function isPhpCoreClass(ClassDependency $dependency): bool
 
             return $reflection->isInternal();
         } catch (\ReflectionException $e) {
-            // Class doesn't exist in the current environment
-            // It's likely a user-defined class in the project being analyzed
             return false;
         }
     }

src/Expression/ForClasses/DependsOnlyOnTheseNamespaces.php

@@ -40,11 +40,11 @@ public function evaluate(ClassDescription $theClass, Violations $violations, str
         /** @var ClassDependency $dependency */
         foreach ($dependencies as $dependency) {
             if ($theClass->namespaceMatches($dependency->getFQCN()->namespace())) {
-                continue; // skip classes in the same namespace
+                continue;
             }
 
             if ($dependency->matchesOneOf(...$this->exclude)) {
-                continue; // skip excluded namespaces
+                continue;
             }
 
             if (!$dependency->matchesOneOf(...$this->namespaces)) {

src/Expression/ForClasses/NotDependsOnTheseNamespaces.php

@@ -40,7 +40,7 @@ public function evaluate(ClassDescription $theClass, Violations $violations, str
         /** @var ClassDependency $dependency */
         foreach ($dependencies as $dependency) {
             if ($dependency->matchesOneOf(...$this->exclude)) {
-                continue; // skip excluded namespaces
+                continue;
             }
 
             if ($dependency->matchesOneOf(...$this->namespaces)) {

tests/Unit/Analyzer/ClassDescriptionBuilderTest.php

@@ -194,8 +194,6 @@ public function test_it_should_filter_out_php_core_classes(): void
             ->build();
 
         self::assertInstanceOf(ClassDescription::class, $classDescription);
-
-        // PHP core classes should be filtered out
         self::assertCount(0, $classDescription->getDependencies());
     }
 
@@ -210,8 +208,6 @@ public function test_it_should_not_filter_user_defined_classes_in_root_namespace
             ->build();
 
         self::assertInstanceOf(ClassDescription::class, $classDescription);
-
-        // User-defined classes in root namespace should NOT be filtered
         self::assertCount(1, $classDescription->getDependencies());
         self::assertEquals('NonExistentUserClass', $classDescription->getDependencies()[0]->getFQCN()->toString());
     }
@@ -228,8 +224,6 @@ public function test_it_should_not_filter_user_defined_classes_with_namespace():
             ->build();
 
         self::assertInstanceOf(ClassDescription::class, $classDescription);
-
-        // User-defined classes with namespaces should not be filtered
         self::assertCount(2, $classDescription->getDependencies());
     }
 
@@ -240,16 +234,14 @@ public function test_it_should_filter_mixed_dependencies_correctly(): void
         $classDescription = (new ClassDescriptionBuilder())
             ->setFilePath('src/Foo.php')
             ->setClassName($FQCN)
-            ->addDependency(new ClassDependency('DateTime', 10)) // PHP core - filtered
-            ->addDependency(new ClassDependency('Vendor\Package\SomeClass', 15)) // Namespaced - kept
-            ->addDependency(new ClassDependency('Exception', 20)) // PHP core - filtered
-            ->addDependency(new ClassDependency('NonExistentUserClass', 25)) // User root class - kept
-            ->addDependency(new ClassDependency('PDO', 30)) // PHP core - filtered
+            ->addDependency(new ClassDependency('DateTime', 10))
+            ->addDependency(new ClassDependency('Vendor\Package\SomeClass', 15))
+            ->addDependency(new ClassDependency('Exception', 20))
+            ->addDependency(new ClassDependency('NonExistentUserClass', 25))
+            ->addDependency(new ClassDependency('PDO', 30))
             ->build();
 
         self::assertInstanceOf(ClassDescription::class, $classDescription);
-
-        // Should keep only the 2 non-PHP-core dependencies
         self::assertCount(2, $classDescription->getDependencies());
 
         $dependencies = $classDescription->getDependencies();
@@ -261,19 +253,14 @@ public function test_it_should_filter_internal_classes_with_namespaces(): void
     {
         $FQCN = 'MyClass';
 
-        // ReflectionClass is a PHP internal class in the root namespace
-        // If other internal namespaced classes exist (e.g., MongoDB\Driver\Manager),
-        // they should also be filtered. We test with ReflectionClass which is always available.
         $classDescription = (new ClassDescriptionBuilder())
             ->setFilePath('src/Foo.php')
             ->setClassName($FQCN)
-            ->addDependency(new ClassDependency('ReflectionClass', 10)) // Internal root - filtered
-            ->addDependency(new ClassDependency('App\MyClass', 15)) // User namespaced - kept
+            ->addDependency(new ClassDependency('ReflectionClass', 10))
+            ->addDependency(new ClassDependency('App\MyClass', 15))
             ->build();
 
         self::assertInstanceOf(ClassDescription::class, $classDescription);
-
-        // ReflectionClass should be filtered, only App\MyClass should remain
         self::assertCount(1, $classDescription->getDependencies());
         self::assertEquals('App\MyClass', $classDescription->getDependencies()[0]->getFQCN()->toString());
     }

tests/Unit/Expressions/ForClasses/NotHaveDependencyOutsideNamespaceTest.php

@@ -97,8 +97,6 @@ public function test_it_should_automatically_exclude_php_core_classes(): void
         $violations = new Violations();
         $notHaveDependencyOutsideNamespace->evaluate($classDescription, $violations, $because);
 
-        // PHP core classes are automatically filtered at the ClassDescriptionBuilder level
-        // So only 'another\class' should be reported as a violation
         self::assertEquals(1, $violations->count());
     }
 }