diff --git a/doc/coding_standards.rst b/doc/coding_standards.rst
index d7daa08b50..dcae56da19 100644
--- a/doc/coding_standards.rst
+++ b/doc/coding_standards.rst
@@ -88,21 +88,34 @@ standards:
     [1, 2, 3]
     {'name': 'Fabien'}
 
-* Use snake case for all variable names (provided by the application and
-  created in templates):
+* Do not put any spaces before and after ``=`` in macro argument declarations:
 
   .. code-block:: twig
 
-    {% set name = 'Fabien' %}
-    {% set first_name = 'Fabien' %}
+    {% macro html_input(class="input") %}
 
-* Use snake case for all function/filter/test names:
+* Put exactly one space after the ``:`` sign in macro argument declarations:
 
   .. code-block:: twig
 
+    {% macro html_input(class: "input") %}
+
+* Use snake case for all variable names (provided by the application and
+  created in templates), function/filter/test names, argument names and named
+  arguments:
+
+  .. code-block:: twig
+
+    {% set name = 'Fabien' %}
+    {% set first_name = 'Fabien' %}
+
     {{ 'Fabien Potencier'|to_lower_case }}
     {{ generate_random_number() }}
 
+    {% macro html_input(class_name) %}
+
+    {{ html_input(class_name: 'pwd') }}
+
 * Indent your code inside tags (use the same indentation as the one used for
   the target language of the rendered template):