Code review hates {@inheritdoc}

[agentrickard]

We seems to be using the latest versions of Coder and PHP_CodeSniffer and yet...

Code:

  /**
   * {inheritdoc}
   */
  public static function getCacheContexts() {
    return ['cookies:' . AuthenticationInterface::ROLE_COOKIE_NAME];
  }

Test result:

     [echo] $> vendor/bin/phpcs --standard=/var/www/html/vendor/drupal/coder/coder_sniffer/Drupal/ruleset.xml --extensions=php,module,inc,install,test,profile,theme,info,yml web/modules/custom web/themes/custom/tc_theme/tc_theme.theme
     [exec] 
     [exec] FILE: /var/www/html/web/modules/custom/tcauthentication/src/AuthenticationBase.php
     [exec] ----------------------------------------------------------------------------------
     [exec] FOUND 8 ERRORS AFFECTING 4 LINES
     [exec] ----------------------------------------------------------------------------------
     [exec]   76 | ERROR | Doc comment short description must start with a capital letter
     [exec]   76 | ERROR | Doc comment short description must end with a full stop
     [exec]   83 | ERROR | Doc comment short description must start with a capital letter
     [exec]   83 | ERROR | Doc comment short description must end with a full stop
     [exec]  106 | ERROR | Doc comment short description must start with a capital letter
     [exec]  106 | ERROR | Doc comment short description must end with a full stop
     [exec]  115 | ERROR | Doc comment short description must start with a capital letter
     [exec]  115 | ERROR | Doc comment short description must end with a full stop
     [exec] ----------------------------------------------------------------------------------
     [exec] 
     [exec] Time: 

References :

• https://github.com/squizlabs/PHP_CodeSniffer/wiki/Customisable-Sniff-Properties#squizcommentingfunctioncomment
• Squiz.Commenting.FunctionComment.MissingReturn @inheritDoc not resolved? squizlabs/PHP_CodeSniffer#2770