javascript-coding-standards.markdown

@@ -110,9 +110,7 @@ class FooBar
 * Exception message strings should be concatenated using sprintf.
 
 
-
-
-
+### Naming Conventions
 * Use camelCase, not underscores, for variable, function and method names, arguments;
 
 * Use underscores for option names and parameter names;
@@ -124,16 +122,21 @@ class FooBar
 * Suffix interfaces with Interface;
 
 * Suffix traits with Trait;
+
 * Suffix exceptions with Exception;
+
 * Use alphanumeric characters and underscores for file names;
-* Don't forget to look at the more verbose Conventions document for more subjective naming considerations.
 
+* Don't forget to look at the more verbose Conventions document for more subjective naming considerations.
 
 
 
+### Documentation
 
+* Add PHPDoc blocks for all classes, methods, and functions;
 
 * Omit the @return tag if the method does not return anything;
+
 * The @package and @subpackage annotations are not used.
 
 
@@ -141,6 +144,7 @@ class FooBar
 
 
 
+
 #### References
 
 PDF versions of some of these documents are attached, in case the web page does not exist anymore, prefer the actual web page if available.