Code formatting rules: newline, variables, comments

Signed-off-by: Dmitry Stoletov <[email protected]>

README.md

@@ -4,6 +4,29 @@
 
 ## Code formatting rules
 
+### Variables
+
+The option alignment.variables will be align list of variables.
+
+```lua
+local a  = 1  -- comment
+local bb = 22 -- comment
+
+local c = "short text" -- comment
+```
+
+### Comments
+
+Skipped space between a double hyphen and text will be revert. Semantic line
+(only hyphens) will not has the space.
+
+```lua
+--------------------------------
+-- Description
+-- params:  - input
+--          - output
+```
+
 ### Tables
 
 If you create an empty table or with only field key or
@@ -52,3 +75,56 @@ local t = {
     -- comment
 }
 ```
+
+### Newline
+
+If return statement inside block with other statements.
+
+```lua
+function isFalse()
+    return false
+end
+
+function calc(a, b)
+    local c = a + b
+
+    return c
+end
+```
+
+A function with other statements.
+
+```lua
+function isFalse()
+    return false
+end
+
+isFalse()
+```
+
+If a function has parameters more max line length.
+
+```lua
+function very_long_name(
+    very_long_name_parameter_1,
+    very_long_name_parameter_2,
+    very_long_name_parameter_3
+)
+    -- stuff
+end
+```
+
+If a function call has parameters more max line length.
+
+```lua
+very_long_name_function_call(
+    {a = 1, b = 2, c = 3},
+    very_long_name_parameter,
+    {
+        a = 1,
+        b = 2,
+        c = 3,
+        d = 4,
+    }
+)
+```