From 79a26b393d6c8c6e052ac014ebcad478d60dcb38 Mon Sep 17 00:00:00 2001 From: Javier Spagnoletti Date: Fri, 26 Jun 2015 10:53:23 -0300 Subject: [PATCH] [Contributing] [Standards] Added note about phpdoc_separation. | Q | A | ------------- | --- | Doc fix? | no | New docs? | no | Applies to | 2.8+ | Fixed tickets | --- contributing/code/standards.rst | 4 ++++ 1 file changed, 4 insertions(+) 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.