1 files changed, 10 insertions, 2 deletions
diff --git a/docs/CODE_STYLE.md b/docs/CODE_STYLE.md
index bcf13b46d..e06b0b8ea 100644
--- a/docs/CODE_STYLE.md
+++ b/docs/CODE_STYLE.md
@@ -56,7 +56,7 @@ resolution screens:
    code windows next to each other on the same screen - as well as multiple
    terminal and debugging windows.
 
-## Open brace on the same line
+## Braces
 
 In if/while/do/for expressions, we write the open brace on the same line as
 the keyword and we then set the closing brace on the same indentation level as
@@ -66,6 +66,14 @@ the initial keyword. Like this:
       /* clearly a youngster */
     }
 
+When we write functions however, the opening brace should be in the first
+column of the first line:
+
+    int main(int argc, char **argv)
+    {
+      return 1;
+    }
+
 ## 'else' on the following line
 
 When adding an `else` clause to a conditional expression using braces, we add
@@ -75,7 +83,7 @@ it on a new line after the closing brace. Like this:
       /* clearly a youngster */
     }
     else {
-      /* probably intelligent */
+      /* probably grumpy */
     }
 
 ## No space before parentheses