It's an absolute waste of time and effort.
Update coding standards to say:
Every method MUST be documented, EXCEPT test case methods (e.g., MyTestClass::testFooBar()) when the method name itself sufficiently documents the method's purpose. If more information is needed to describe the the test case, a docblock should still be added. All other methods in test classes (helper methods, assertions, fixtures, etc.) still require documentation.
(proposal from #24)
Needs work
Documentation
Enhances developer experience.
Worse Than Failure. Approximates the unpleasant remark made by Drupal developers when they first encounter a particular (mis)feature.
Not all content is available!
It's likely this issue predates Contrib.social: some issue and comment data are missing.
@param and @return for new code or any test being updated are now covered by type hinting.
This does not cover (sorry) @covers but I think we could allow only @covers in that case.
Helper methods - if they're on an individual test, no docs for me. If they're on a base test class or trait, they should have docs anyway.