Merge pull request #210 from waddie96/patch-2

Revise formatting behavior documentation

Author: CppCXY

docs/format_action_EN.md

@@ -1,10 +1,18 @@
-# Introduction to formatting behavior
-
-The formatter is highly configurable, supports simple extended syntax, has a variety of styles, and is extremely performant. Suitable for formatting configuration files, formatting large code bases, etc. Suitable for a unified code style within the project, or individual developers with special preferences.
+# 📚 Formatting behavior
 
 ## Basic formatting
 
-The basic formatting principle of the code is mainly to add basic whitespace on both sides of the symbol, achieve correct indentation for the statement block, set the appropriate spacing between different statements, keep the token in the sequential position will not change, and clean up the excess space at the end of the line.
+EmmyLuaCodeStyle applies a consistent set of rules to ensure readability and maintainability of Lua source code. Its core formatting principles include:
+
+- Adding appropriate whitespace around symbols
+- Ensuring correct indentation for statement blocks
+- Maintaining consistent spacing between statements
+- Preserving token order to avoid semantic changes
+- Removing trailing whitespace at the end of lines
+
+These rules guarantee a uniform code structure across projects while respecting the logical flow of Lua syntax.
+
+**Example:**
 
 ```lua
 local t=123 --local
@@ -18,12 +26,13 @@ local e = a+b+c+d
 function fff(a,b,c) end
 function ff2()
 --[[
-    long comment
+    long description.
 ]]
 end
 ```
 
-will be formatted as:
+**Formatted output:**
+
 ```lua
 local t = 123 --local
 aaa, bbbb = 1123, 2342
@@ -39,15 +48,16 @@ end
 
 function ff2()
     --[[
-    long comment
+    long description.
 ]]
 end
 ```
 
-## Alignment
+### Alignment
 
-On top of basic requirements, formatting tools provide satisfaction for advanced aesthetic needs, and code alignment is an important component.
+Beyond basic formatting, it supports advanced alignment features to improve clarity and readability. Adequate alignment helps developers easily scan related code elements and maintain a clean, consistent structure.
 
+**Example:**
 
 ```lua
 local ttt  = 123 --first
@@ -66,7 +76,7 @@ local c = {
 }
 ```
 
-will be formatted as:
+**Formatted output:**
 
 ```lua
 local ttt = 123 --first
@@ -84,3 +94,28 @@ local c = {
     { 1,     2,    3 }
 }
 ```
+
+The formatter aligns assignment operators, table fields, and array elements in a way that balances readability with minimal unnecessary whitespace. Alignment can be configured or disabled entirely, per project coding conventions.
+
+### Line wrapping
+
+EmmyLua provides flexible line wrapping rules through configuration options such as `max_line_length = 120` and `continuation_indent = 4`. Long expressions, function parameters, and table constructors are automatically wrapped according to the configurable maximum line length.
+
+**Example:**
+
+```lua
+local function longFunctionNameWithManyParameters(param1, param2, param3, param4, param5, param6)
+    -- function body
+end
+```
+
+**Formatted output:**
+
+```lua
+local function longFunctionName(
+    with_many_parameters, param_two, param_three,
+    configurable, continuation_indent
+)
+    -- function body
+end
+```