symfony
diff --git a/‎contributing/code/standards.rst
Copy file name to clipboardExpand all lines: contributing/code/standards.rst
+2-1Lines changed: 2 additions & 1 deletion b/‎contributing/code/standards.rst
Copy file name to clipboardExpand all lines: contributing/code/standards.rst
+2-1Lines changed: 2 additions & 1 deletion
@@ -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
 ~~~~~~~