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

Comments

wim leers created an issue.