From 3391e51aeeaaf9089d5906f5e462017690708590 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 6 Feb 2018 13:02:03 +0100
Subject: [PATCH] Recommend to never inline PHPDoc blocks

---
 contributing/code/standards.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/contributing/code/standards.rst b/contributing/code/standards.rst
index 431b8f3a24e..36d13fc36a4 100644
--- 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
 ~~~~~~~