Currently, the function doc of "addCacheableDependency()" inside "/core/lib/Drupal/Core/Cache/RefinableCacheableDependencyTrait.php" is defined as follows:
/**
* {@inheritdoc}
*/
This doc comment states, that the "parent" trait "CacheableDependencyTrait" defines an identical named function with a doc comment which states, what the function does. Unfortunately, "CacheableDependencyTrait" does not implement "addCacheableDependency()" and therefore does not present a function doc.
This is the Case for SEVERAL functions declared inside "RefinableCacheableDependencyTrait" as well as "CacheableDependencyTrait". These important methods should be documented!
Document:
Inside "/core/lib/Drupal/Core/Cache/RefinableCacheableDependencyTrait.php"
and
Inside "web/core/lib/Drupal/Core/Cache/CacheableDependencyTrait.php".
Closed: works as designed
11.0 🔥
My apologies, the methods are documented inside "\Drupal\Core\Cache\CacheableDependencyInterface" and "\Drupal\Core\Cache\RefinableCacheableDependencyInterface" respectively.
Updating title, tags and version number based on recent announcement at https://www.drupal.org/about/core/blog/new-drupal-core-branching-scheme-... →