diff --git a/contributing/code/standards.rst b/contributing/code/standards.rst index 40ca8c4981d..a11ac1d34a6 100644 --- a/contributing/code/standards.rst +++ b/contributing/code/standards.rst @@ -172,6 +172,10 @@ Documentation * Add PHPDoc blocks for all classes, methods, and functions; +* Group annotations together so that annotations of the same type immediately + follow each other, and annotations of a different type are separated by a + single blank line; + * Omit the ``@return`` tag if the method does not return anything; * The ``@package`` and ``@subpackage`` annotations are not used.