Coding standard improvements (closes symfony#753)

helmer · weaverryan · commit 8993150a0673 · 2011-10-11T06:53:05.000-05:00
diff --git a/contributing/code/standards.rst b/contributing/code/standards.rst
@@ -77,7 +77,7 @@ Structure
 * Add a single space before the opening parenthesis of a control keyword
   (`if`, `else`, `for`, `while`, ...);
 
-* Add a blank line before `return` statements;
+* Add a blank line before `return` statements unless return is alone inside a statement-group;
 
 * Don't add trailing spaces at the end of lines;
 
@@ -128,6 +128,8 @@ Documentation
 
 * Add PHPDoc blocks for all classes, methods, and functions;
 
+* Omit `@return` tag in case method does not return anything;
+
 * The `@package` and `@subpackage` annotations are not used.
 
 License
