Issue #3105950 by spokje, quietone, peterkokot, ankithashetty, longwave: [meta] Fix 'Drupal.Commenting.ClassComment.Missing' coding standard

Author: nod_

lib/Drupal/Component/Plugin/Discovery/DiscoveryCachedTrait.php

@@ -2,6 +2,9 @@
 
 namespace Drupal\Component\Plugin\Discovery;
 
+/**
+ * Trait for accessing cached definitions of the plugin discovery component.
+ */
 trait DiscoveryCachedTrait {
 
   use DiscoveryTrait;

lib/Drupal/Core/Batch/BatchStorage.php

@@ -8,6 +8,9 @@
 use Drupal\Core\Database\DatabaseException;
 use Symfony\Component\HttpFoundation\Session\SessionInterface;
 
+/**
+ * Defines the storage handler class for batches.
+ */
 class BatchStorage implements BatchStorageInterface {
 
   /**

lib/Drupal/Core/Cache/ApcuBackendFactory.php

@@ -5,6 +5,9 @@
 use Drupal\Component\Datetime\TimeInterface;
 use Drupal\Core\Site\Settings;
 
+/**
+ * Defines the APCU backend factory.
+ */
 class ApcuBackendFactory implements CacheFactoryInterface {
 
   /**

lib/Drupal/Core/Cache/CacheFactory.php

@@ -2,12 +2,12 @@
 
 namespace Drupal\Core\Cache;
 
-/**
- * Defines the cache backend factory.
- */
 use Drupal\Core\Site\Settings;
 use Psr\Container\ContainerInterface;
 
+/**
+ * Defines the cache backend factory.
+ */
 class CacheFactory implements CacheFactoryInterface {
 
   /**

lib/Drupal/Core/Cache/DatabaseBackendFactory.php

@@ -7,6 +7,9 @@
 use Drupal\Core\Database\Connection;
 use Drupal\Core\Site\Settings;
 
+/**
+ * Defines a default cache backend factory.
+ */
 class DatabaseBackendFactory implements CacheFactoryInterface {
 
   /**

lib/Drupal/Core/Cache/MemoryBackendFactory.php

@@ -4,6 +4,9 @@
 
 use Drupal\Component\Datetime\TimeInterface;
 
+/**
+ * Defines a memory cache backend factory.
+ */
 class MemoryBackendFactory implements CacheFactoryInterface {
 
   /**

lib/Drupal/Core/Cache/MemoryCache/MemoryCacheFactory.php

@@ -5,6 +5,9 @@
 use Drupal\Component\Datetime\TimeInterface;
 use Drupal\Core\Cache\CacheFactoryInterface;
 
+/**
+ * The memory cache factory.
+ */
 class MemoryCacheFactory implements CacheFactoryInterface {
 
   /**

lib/Drupal/Core/Cache/MemoryCounterBackendFactory.php

@@ -4,6 +4,9 @@
 
 use Drupal\Component\Datetime\TimeInterface;
 
+/**
+ * Defines the memory counter backend factory.
+ */
 class MemoryCounterBackendFactory implements CacheFactoryInterface {
 
   /**

lib/Drupal/Core/Cache/NullBackendFactory.php

@@ -2,6 +2,9 @@
 
 namespace Drupal\Core\Cache;
 
+/**
+ * Defines a stub cache backend factory.
+ */
 class NullBackendFactory implements CacheFactoryInterface {
 
   /**

lib/Drupal/Core/Cache/PhpBackendFactory.php

@@ -4,6 +4,9 @@
 
 use Drupal\Component\Datetime\TimeInterface;
 
+/**
+ * Defines a PHP cache backend factory.
+ */
 class PhpBackendFactory implements CacheFactoryInterface {
 
   /**

lib/Drupal/Core/ClassLoader/BackwardsCompatibilityClassLoader.php

@@ -4,6 +4,9 @@
 
 namespace Drupal\Core\ClassLoader;
 
+/**
+ * Adds backwards compatibility support for deprecated classes.
+ */
 final class BackwardsCompatibilityClassLoader {
 
   public function __construct(protected array $movedClasses) {}

lib/Drupal/Core/Config/ConfigImporterEvent.php

@@ -4,6 +4,9 @@
 
 use Drupal\Component\EventDispatcher\Event;
 
+/**
+ * Configuration event fired when importing a configuration object.
+ */
 class ConfigImporterEvent extends Event {
   /**
    * Configuration import object.

lib/Drupal/Core/Config/ConfigInstaller.php

@@ -9,6 +9,9 @@
 use Drupal\Core\Installer\InstallerKernel;
 use Symfony\Contracts\EventDispatcher\EventDispatcherInterface;
 
+/**
+ * The config installer.
+ */
 class ConfigInstaller implements ConfigInstallerInterface {
 
   /**

lib/Drupal/Core/Config/Plugin/Validation/Constraint/LangcodeRequiredIfTranslatableValuesConstraint.php

@@ -8,6 +8,9 @@
 use Drupal\Core\Validation\Attribute\Constraint;
 use Symfony\Component\Validator\Constraint as SymfonyConstraint;
 
+/**
+ * Validation constraint for translatable configuration.
+ */
 #[Constraint(
   id: 'LangcodeRequiredIfTranslatableValues',
   label: new TranslatableMarkup('Translatable config has langcode', [], ['context' => 'Validation']),

lib/Drupal/Core/Entity/EntityAutocompleteMatcherInterface.php

@@ -2,6 +2,9 @@
 
 namespace Drupal\Core\Entity;
 
+/**
+ * Provides an interface for the entity autocomplete matcher.
+ */
 interface EntityAutocompleteMatcherInterface {
 
   /**

lib/Drupal/Core/Recipe/InputCollectorInterface.php

@@ -6,6 +6,9 @@
 
 use Drupal\Core\TypedData\DataDefinitionInterface;
 
+/**
+ * The interface for classes collecting input values for recipes.
+ */
 interface InputCollectorInterface {
 
   public function collectValue(string $name, DataDefinitionInterface $definition, mixed $default_value): mixed;

lib/Drupal/Core/Routing/LazyRouteCollection.php

@@ -6,6 +6,9 @@
 use Symfony\Component\Routing\Route;
 use Symfony\Component\Routing\RouteCollection;
 
+/**
+ * The lazy route collection.
+ */
 class LazyRouteCollection extends RouteCollection {
   /**
    * The route provider for this generator.

lib/Drupal/Core/Validation/Plugin/Validation/Constraint/CountryCodeConstraint.php

@@ -11,6 +11,9 @@
 use Symfony\Component\DependencyInjection\ContainerInterface;
 use Symfony\Component\Validator\Constraints\Choice;
 
+/**
+ * Validation constraint for country codes.
+ */
 #[Constraint(
   id: 'CountryCode',
   label: new TranslatableMarkup('CountryCode', [], ['context' => 'Validation']),

phpcs.xml.dist

@@ -49,12 +49,6 @@
   <rule ref="Drupal.Classes.UseGlobalClass"/>
   <rule ref="Drupal.Classes.UseLeadingBackslash"/>
   <rule ref="Drupal.Commenting.ClassComment"/>
-  <rule ref="Drupal.Commenting.ClassComment.Missing">
-    <include-pattern>*/Functional/*</include-pattern>
-    <include-pattern>*/tests/modules/*</include-pattern>
-    <include-pattern>./core/tests/*</include-pattern>
-    <include-pattern>./core/modules/*</include-pattern>
-  </rule>
   <rule ref="Drupal.Commenting.DataTypeNamespace"/>
   <rule ref="Drupal.Commenting.Deprecated"/>
   <rule ref="Drupal.Commenting.DocComment">

themes/starterkit_theme/src/StarterKit.php

@@ -4,6 +4,9 @@
 
 use Drupal\Core\Theme\StarterKitInterface;
 
+/**
+ * Interacts with theme generation.
+ */
 final class StarterKit implements StarterKitInterface {
 
   /**