[#5838] Tweaking comment - the phpdoc policy is not concrete

weaverryan · weaverryan · commit 0aa25f8f3304 · 2017-07-20T08:04:48.000-04:00
diff --git a/contributing/code/standards.rst b/contributing/code/standards.rst
@@ -225,8 +225,8 @@ Service Naming Conventions
 Documentation
 -------------
 
-* Add PHPDoc blocks for all classes, methods, and functions, except when the
-  comments are trivial (e.g. basic getter and setter methods);
+* Add PHPDoc blocks for all classes, methods, and functions (though you may
+  be asked to remove PHPDoc that do not add value);
 
 * Group annotations together so that annotations of the same type immediately
   follow each other, and annotations of a different type are separated by a
