- Status changed to RTBC
over 1 year ago 6:31pm 20 January 2023 - Status changed to Fixed
over 1 year ago 8:00pm 20 January 2023 Automatically closed - issue fixed for 2 weeks with no activity.
If a class has a method that is overriding a method from a parent class/interface, and the documentation is identical, use this short form for the documentation:
/** * {@inheritdoc} */ public function …
( https://www.drupal.org/docs/develop/standards/php/api-documentation-and-... → , 2nd bullet-point)
(At least) PHPStorm out-of-the-box comes up with {@inheritDoc} (notice the capital D) as the default autocomplete option.
Let's fix the occurrences that are currently already in the Core codebase and use a Slevomat Rule to make sure no new occurrences creep in.
The SlevomatCodingStandard.Commenting.ForbiddenAnnotations and SlevomatCodingStandard.Commenting.ForbiddenComments rules have been enabled to standardize the format of {@inheritdoc} for API docblocks.
Fixed
9.5
It involves compliance with, or the content of coding standards. Requires broad community agreement.
Not all content is available!
It's likely this issue predates Contrib.social: some issue and comment data are missing.
Automatically closed - issue fixed for 2 weeks with no activity.