Problem/Motivation

Follow up https://www.drupal.org/project/drupal/issues/474684#comment-13509359

+++ b/core/lib/Drupal/Core/ProxyClass/Extension/ModuleRequiredByThemesUninstallValidator.php
@@ -0,0 +1,88 @@
+     * @see \Drupal\Component\ProxyBuilder
+     */

\Drupal\Component\ProxyBuilder is a namespace, it's better changing it to \Drupal\Component\ProxyBuilder\ProxyBuilder

Proposed resolution

Introduce a new coding standard to disallow @see to reference a namespace just fix those wrongly referenced ones.

Remaining tasks

Needs discussion

User interface changes

API changes

Data model changes

Release notes snippet

Comments

jungle created an issue. See original summary.

cilefen’s picture

cilefen commented
Issue tags: +Documentation
longwave’s picture

longwave
he/him
Primary language English
Location UK
commented

Can we have a rule that @see beginning with a backslash must reference an existing class or method? That would also cover #3100251: Several code comments have incorrect namespaces for classes or interfaces they reference

Version: 8.9.x-dev » 9.1.x-dev

Drupal 8.9.0-beta1 was released on March 20, 2020. 8.9.x is the final, long-term support (LTS) minor release of Drupal 8, which means new developments and disruptive changes should now be targeted against the 9.1.x-dev branch. For more information see the Drupal 8 and 9 minor version schedule and the Allowed changes during the Drupal 8 and 9 release cycles.

Version: 9.1.x-dev » 9.2.x-dev

Drupal 9.1.0-alpha1 will be released the week of October 19, 2020, which means new developments and disruptive changes should now be targeted for the 9.2.x-dev branch. For more information see the Drupal 9 minor version schedule and the Allowed changes during the Drupal 9 release cycle.

Version: 9.2.x-dev » 9.3.x-dev

Drupal 9.2.0-alpha1 will be released the week of May 3, 2021, which means new developments and disruptive changes should now be targeted for the 9.3.x-dev branch. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

quietone’s picture

quietone commented
Status: Active » Closed (duplicate)
Related issues: +#3092424: ProxyBuilder generates incorrect @see reference

This is a duplicate of #3092424: ProxyBuilder generates incorrect @see reference.

Therefore, closing as a duplicate. If that is wrong, reopen the issue, by setting the status to 'Active', and add a comment.

Thanks!