📚 Update doc

Author: VincentLanglet

docs/standards.md

@@ -147,3 +147,9 @@ we do not respect this rule:
 ```
 <rule ref="SymfonyCustom.Namespaces.UnusedUse"/>
 ```
+
+- Add a single space around comment tag (`@var`, `@return`, `...`)
+
+```
+<rule ref="SymfonyCustom.WhiteSpace.DocCommentTagSpacing"/>
+```

docs/standards/symfony.md

@@ -5,57 +5,57 @@ From [symfony standard](http://symfony.com/doc/current/contributing/code/standar
 - Add a single space after each comma delimiter
 
 ```
-<rule ref="SymfonyCustom.Array.ArrayDeclaration" />
+<rule ref="SymfonyCustom.Array.ArrayDeclaration"/>
 ```
 
 - Add a single space around binary operators (`==`, `&&`, `...`)
  with the exception of the concatenation (`.`) operator
 
 ```
-<rule ref="Squiz.WhiteSpace.OperatorSpacing" />
+<rule ref="Squiz.WhiteSpace.OperatorSpacing"/>
 <rule ref="Squiz.Strings.ConcatenationSpacing">
     <properties>
-        <property name="ignoreNewlines" value="true" />
+        <property name="ignoreNewlines" value="true"/>
     </properties>
 </rule>
 ```
 
 - Place unary operators (`!`, `--`, `...`) adjacent to the affected variable
 
 ```
-<rule ref="SymfonyCustom.WhiteSpace.SpaceUnaryOperatorSpacing" />
+<rule ref="SymfonyCustom.WhiteSpace.SpaceUnaryOperatorSpacing"/>
 ```
 
 - Always use identical comparison unless you need type juggling
 
 ```
-<rule ref="SymfonyCustom.Formatting.StrictComparison" />
+<rule ref="SymfonyCustom.Formatting.StrictComparison"/>
 ```
 
 - Use Yoda conditions when checking a variable against an expression
 
 ```
-<rule ref="SymfonyCustom.Formatting.YodaCondition" />
+<rule ref="SymfonyCustom.Formatting.YodaCondition"/>
 ```
 
 - Add a comma after each array item in a multi-line array, even after the last one
 
 ```
-<rule ref="SymfonyCustom.Array.ArrayDeclaration" />
+<rule ref="SymfonyCustom.Array.ArrayDeclaration"/>
 ```
 
 - Add a blank line before return statements,
  unless the return is alone inside a statement-group (like an `if` statement)
 
 ```
-<rule ref="SymfonyCustom.Formatting.BlankLineBeforeReturn" />
+<rule ref="SymfonyCustom.Formatting.BlankLineBeforeReturn"/>
 ```
 
 - Use `return null` when a function explicitly returns null values
  and use `return` when the function returns void values
 
 ```
-<rule ref="SymfonyCustom.Commenting.FunctionComment" />
+<rule ref="SymfonyCustom.Commenting.FunctionComment"/>
 ```
 
 - Use braces to indicate control structure body regardless of the number of statements it contains
@@ -73,15 +73,15 @@ Covered by `PSR2`
 - Declare class properties before methods
 
 ```
-<rule ref="SymfonyCustom.Classes.PropertyDeclaration" />
+<rule ref="SymfonyCustom.Classes.PropertyDeclaration"/>
 ```
 
 - Declare public methods first, then protected ones and finally private ones.
  The exceptions to this rule are the class constructor and the `setUp()` and `tearDown()` methods of PHPUnit tests,
   which must always be the first methods to increase readability
 
 ```
-<rule ref="SymfonyCustom.Functions.ScopeOrder" />
+<rule ref="SymfonyCustom.Functions.ScopeOrder"/>
 ```
 
 - Declare all the arguments on the same line as the method/function name, no matter how many arguments there are
@@ -91,25 +91,25 @@ Not checked because of the limit of 120 characters per line
 - Use parentheses when instantiating classes regardless of the number of arguments the constructor has
 
 ```
-<rule ref="SymfonyCustom.Objects.ObjectInstantiation" />
+<rule ref="SymfonyCustom.Objects.ObjectInstantiation"/>
 ```
 
 - Exception and error message strings must be concatenated using `sprintf`
 
 ```
-<rule ref="SymfonyCustom.Errors.ExceptionMessage" />
+<rule ref="SymfonyCustom.Errors.ExceptionMessage"/>
 ```
 
 - Calls to `trigger_error` with type `E_USER_DEPRECATED` must be switched to opt-in via `@`operator
 
 ```
-<rule ref="SymfonyCustom.Errors.UserDeprecated" />
+<rule ref="SymfonyCustom.Errors.UserDeprecated"/>
 ```
 
 - Do not use `else`, `elseif`, `break` after `if` and `case` conditions which return or throw something
 
 ```
-<rule ref="SymfonyCustom.Formatting.ConditionalReturnOrThrowSniff" />
+<rule ref="SymfonyCustom.Formatting.ConditionalReturnOrThrowSniff"/>
 ```
 
 - Do not use spaces around `[` offset accessor and before `]` offset accessor
@@ -134,43 +134,43 @@ Covered by `PSR2` completed by
 
 Covered by `PSR1` completed by
 ```
-<rule ref="Squiz.Classes.ValidClassName" />
+<rule ref="Squiz.Classes.ValidClassName"/>
 ```
 
 - Prefix abstract classes with `Abstract`
 
 ```
-<rule ref="SymfonyCustom.NamingConventions.ValidClassName" />
+<rule ref="SymfonyCustom.NamingConventions.ValidClassName"/>
 ```
 
 - Suffix interfaces with `Interface`
 
 ```
-<rule ref="SymfonyCustom.NamingConventions.ValidClassName" />
+<rule ref="SymfonyCustom.NamingConventions.ValidClassName"/>
 ```
 
 - Suffix traits with `Trait`
 
 ```
-<rule ref="SymfonyCustom.NamingConventions.ValidClassName" />
+<rule ref="SymfonyCustom.NamingConventions.ValidClassName"/>
 ```
 
 - Suffix exceptions with `Exception`
 
 ```
-<rule ref="SymfonyCustom.NamingConventions.ValidClassName" />
+<rule ref="SymfonyCustom.NamingConventions.ValidClassName"/>
 ```
 
 - Use alphanumeric characters and underscores for file names
 
 ```
-<rule ref="SymfonyCustom.NamingConventions.ValidFileName" />
+<rule ref="SymfonyCustom.NamingConventions.ValidFileName"/>
 ```
 
 - For type-hinting in PHPDocs and casting, use `bool`, `int` and `float`
 
 ```
-<rule ref="SymfonyCustom.NamingConventions.ValidScalarTypeName" />
+<rule ref="SymfonyCustom.NamingConventions.ValidScalarTypeName"/>
 ```
 
 ### Documentation
@@ -179,8 +179,8 @@ Covered by `PSR1` completed by
 
 We added exceptions for functions `setUp`, `tearDown` and `tests` with no `@param` or `@return`
 ```
-<rule ref="SymfonyCustom.Commenting.ClassComment" />
-<rule ref="SymfonyCustom.Commenting.FunctionComment" />
+<rule ref="SymfonyCustom.Commenting.ClassComment"/>
+<rule ref="SymfonyCustom.Commenting.FunctionComment"/>
 ```
 
 We added exceptions for param comments
@@ -194,17 +194,17 @@ We added exceptions for param comments
  and annotations of a different type are separated by a single blank line
 
 ```
-<rule ref="SymfonyCustom.Commenting.DocCommentGroupSameType" />
+<rule ref="SymfonyCustom.Commenting.DocCommentGroupSameType"/>
 ```
 
 - Omit the `@return` tag if the method does not return anything
 
 ```
-<rule ref="SymfonyCustom.Commenting.FunctionComment" />
+<rule ref="SymfonyCustom.Commenting.FunctionComment"/>
 ```
 
 - The `@package` and `@subpackage` annotations are not used
 
 ```
-<rule ref="SymfonyCustom.Commenting.DocCommentForbiddenTags" />
+<rule ref="SymfonyCustom.Commenting.DocCommentForbiddenTags"/>
 ```