Closed (duplicate)
Project:
Drupal core
Version:
11.x-dev
Component:
documentation
Priority:
Normal
Category:
Task
Assigned:
Unassigned
Reporter:
Created:
13 May 2015 at 18:35 UTC
Updated:
21 Oct 2025 at 11:23 UTC
Jump to comment: Most recent, Most recent file
Comments
Comment #2
markdorisonRe-rolled patch.
Comment #4
markdorisonI'm pretty sure we could still get these API documentation improvements in to 8.2.x.
Comment #5
dawehner+1
Thank you. This is indeed a quickfix
Comment #6
alexpottThis one is tricky - yes we have a missing docblock sniff that would catch all of these but there's a difference between just adding the inheritdoc (as we do here) and having to write completely new documentation. I can't see how phpcs could detect missing @inheritdoc's because it'd need to load code in an introspectable way which it does not do - it just tokenises. But at the very least I'd expect this issue to be done by interface and not class. For example, \Drupal\views\Plugin\views\filter\InOperator::adminSummary() lacks the @inheritdoc too (and this class is in the inheritance chain of the one being fixed here).
Not really sure what to do here - going class by class feels wrong and also the docs that are being inherited aren't great either. Perhaps a way to do it is start with \Drupal\views\Plugin\views\HandlerBase - improve the docs there are ensure all the things that inherit from it have @inheritdoc.
Comment #10
ivan berezhnov commentedComment #17
Arti Anil Pattewar commentedRerolled patch #2 for D9.4.x.
Comment #18
Arti Anil Pattewar commentedNeeds Review.
Comment #20
smustgrave commented#6 still needs an answer
Comment #22
quietone commentedThis was fixed in #3491289: Fix Drupal.Commenting.FunctionComment.Missing in views filter plugins.