Recommend to never inline PHPDoc blocks

javiereguiluz · javiereguiluz · commit 3391e51aeeaa · 2018-02-06T13:02:03.000+01:00
diff --git a/contributing/code/standards.rst b/contributing/code/standards.rst
@@ -251,7 +251,8 @@ Documentation
 
 * The ``@package`` and ``@subpackage`` annotations are not used;
 
-* Inline the ``@inheritdoc`` tag.
+* Don't inline PHPDoc blocks, even when they contain just one tag (e.g. don't
+  put ``/** {@inheritdoc} */`` in a single line).
 
 License
 ~~~~~~~
