False `Drupal.Commenting.DocCommentStar.StarMissing` report?

Created on 14 August 2025, about 14 hours ago

Problem/Motivation

For the first time, I've encountered this PHPCS violation, and I was puzzled:

FILE: tests/src/Functional/ApiUiContentTemplateControllersTest.php
------------------------------------------------------------------------------------------
FOUND 1 ERROR AFFECTING 1 LINE
------------------------------------------------------------------------------------------
 20 | ERROR | [x] Doc comment star missing (Drupal.Commenting.DocCommentStar.StarMissing)

— https://git.drupalcode.org/project/experience_builder/-/jobs/6214070

Steps to reproduce

The file started with this:

<?php

declare(strict_types=1);

namespace Drupal\Tests\experience_builder\Functional;

use Drupal\Core\Field\FieldStorageDefinitionInterface;
use Drupal\Core\Url;
use Drupal\experience_builder\Entity\ContentTemplate;
use Drupal\field\Entity\FieldConfig;
use Drupal\field\Entity\FieldStorageConfig;
use Drupal\Tests\experience_builder\Traits\GenerateComponentConfigTrait;
use Drupal\user\UserInterface;
use Symfony\Component\HttpFoundation\Response;

/**
 * Tests the details of API routes powering the Content Template UI.
 *
 * @covers \Drupal\experience_builder\Controller\ApiUiContentTemplateControllers
 * @group experience_builder
 */
final class ApiUiContentTemplateControllersTest extends HttpApiTestBase {

… whereas it does NOT complain about this sibling file, with a nearly identical start:

<?php

declare(strict_types=1);

namespace Drupal\Tests\experience_builder\Functional;

use Drupal\Core\Entity\EntityTypeManagerInterface;
use Drupal\Core\Url;
use Drupal\experience_builder\AutoSave\AutoSaveManager;
use Drupal\experience_builder\Entity\JavaScriptComponent;
use Drupal\experience_builder\Entity\Page;
use Drupal\experience_builder\Entity\StagedConfigUpdate;
use Drupal\Tests\experience_builder\Traits\ContribStrictConfigSchemaTestTrait;
use Drupal\user\UserInterface;
use GuzzleHttp\RequestOptions;

/**
 * Tests the details of auto-saving Staged Config Update entities.
 *
 * @covers \Drupal\experience_builder\Controller\ApiStagedConfigUpdateAutoSaveController
 * @group experience_builder
 */
class ApiStagedConfigUpdateAutoSaveControllerTest extends HttpApiTestBase {

So, for now, I just dropped docs, to not be blocked by this: https://git.drupalcode.org/project/experience_builder/-/merge_requests/1...

What am I doing wrong? šŸ˜…

Proposed resolution

Remaining tasks

User interface changes

API changes

Data model changes

šŸ’¬ Support request
Status

Active

Version

8.3

Component

Coder Sniffer

Created by

šŸ‡§šŸ‡ŖBelgium wim leers Ghent šŸ‡§šŸ‡ŖšŸ‡ŖšŸ‡ŗ

Live updates comments and jobs are added and updated live.
Sign in to follow issues

Comments & Activities

Production build 0.71.5 2024