optimize docs

Signed-off-by: oilbeater <liumengxinfly@gmail.com>

Author: oilbeater

docs/rules.md

@@ -1,5 +1,7 @@
-# dslx
-dslx的格式为
+# DSLX
+
+为了适应复杂情况的流量分发，ALB 提供了一组自定义流量匹配 DSL 名为 dslx。 在 Rule 中可以配置 dslx，最终会生成前序表达式供 ALB 规则引擎进行流量匹配。dslx 的格式如下：
+
 ```yaml
   - type: string # matcher
     key: string (optional)
@@ -9,32 +11,45 @@ dslx的格式为
      - - string # op 2
        - string # condition
 ```
-- type指定具体要匹配什么，目前有 HOST URL SRC_IP METHOD HEADER PARAM COOKIE 这几个matcher
-- key指定额外的匹配条件，比如匹配HEADER时，具体是哪一个HEADER.
-   - 当type是HEADER PARAM COOKIE 时，可以指定具体的KEY  
-- 通过type和key我们可以明确要匹配的是什么，通过values指定匹配条件  
-    - values是一个表格，每行表示一个匹配条件
-      - 每行的第一个元素指定匹配条件的操作符
-      - 行与行之间是OR的关系  
+
+- `type` 指定具体要匹配那个属性，目前有 `HOST`,`URL SRC_IP`, `METHOD`, `HEADER`, `PARAM`, `COOKIE` 这几个 matcher。
+  - 多个 matcher 之间的关系是 `AND`。
+- `key` 指定额外的匹配条件，比如匹配 `HEADER` 时，具体是哪一个 `HEADER`：
+   - 当 `type` 是 `HEADER`, `PARAM` 或 `COOKIE` 时，可以指定具体的 `key`。 
+- 通过 `type` 和 `key` 我们可以明确要匹配的是哪个属性，通过 `values` 指定匹配条件： 
+    - `values` 是一个表格，每行表示一个匹配条件：
+      - 每行的第一个元素指定匹配条件的操作符。
+      - 行与行之间是 `OR` 的关系。
+  
 ## matcher
-| HOST   | 请求的域名                                                   |
-|--------|--------------------------------------------------------------|
-| URL    | 请求的url                                                    |
-| SRC_IP | 请求的源地址，会优先使用x_real_ip或者x_forwarded_for的header |
-| METHOD | 请求的方法                                                   |
-| HEADER | 请求的header，可以指定key                                    |
-| PARAM  | url的参数，可以指定key                                       |
-| COOKIE | 请求的cookie，可以指定key                                    |
-## conditions
-| conditions  |                                                |   |
-|-------------|------------------------------------------------|---|
-| EQ          | 相等                                           |   |
-| STARTS_WITH | 前缀匹配                                       |   |
-| ENDS_WITH   | 后缀匹配                                       |   |
-| IN          | value在数组内                                  |   |
-| RANGE       | values是ip，并且在某个ip段内                   |   |
-| EXIST       | 存在这个key，比如存在某个header，param，cookie |   |
-## example
+
+dslx 支持下列字段的匹配：
+
+| 名字   | 描述                                                      |
+|--------|----------------------------------------------------------|
+| HOST   | 请求的域名                                                |
+| URL    | 请求的url                                                |
+| SRC_IP | 请求的源地址，会优先使用 x_real_ip 或者 x_forwarded_for 的 header |
+| METHOD | 请求的方法                                                |
+| HEADER | 请求的 header，可以指定 key                                  |
+| PARAM  | url 的参数，可以指定 key                                     |
+| COOKIE | 请求的 cookie，可以指定 key                                  |
+
+## op
+
+dslx 支持下列的操作符：
+
+| 名字         | 描述                                          |
+|-------------|-----------------------------------------------|
+| EQ          | 相等                                          |
+| STARTS_WITH | 前缀匹配                                       |
+| ENDS_WITH   | 后缀匹配                                       |
+| IN          | value 在数组内                                  |
+| RANGE       | values 是 IP，并且在某个 IP 段内                    |
+| EXIST       | 存在这个 key，比如存在某个 header，param，cookie    |
+
+## Example
+
 ```yaml
   dslx:
   - type: HOST
@@ -48,7 +63,8 @@ dslx的格式为
     - - STARTS_WITH
       - /b
 ```
-为`[AND [EQ HOST a.com] [OR [STARTS_WITH URL /a] [STARTS_WITH URL /a]]`
+
+最终生成的前序表达式为 `[AND [EQ HOST a.com] [OR [STARTS_WITH URL /a] [STARTS_WITH URL /a]]`。
 
 ```yaml
   dslx:
@@ -88,4 +104,5 @@ dslx的格式为
       - "1.1.1.100"
 
 ```
-为`["AND",["EQ","METHOD","POST"],["OR",["STARTS_WITH","URL","/app-a"],["STARTS_WITH","URL","/app-b"]],["EQ","PARAM","group","vip"],["ENDS_WITH","HOST",".app.com"],["IN","HEADER","location","east-1","east-2"],["EXIST","COOKIE","uid"],["RANGE","SRC_IP","1.1.1.1","1.1.1.100"]]`
+
+最终生成的前序表达式为 `["AND",["EQ","METHOD","POST"],["OR",["STARTS_WITH","URL","/app-a"],["STARTS_WITH","URL","/app-b"]],["EQ","PARAM","group","vip"],["ENDS_WITH","HOST",".app.com"],["IN","HEADER","location","east-1","east-2"],["EXIST","COOKIE","uid"],["RANGE","SRC_IP","1.1.1.1","1.1.1.100"]]`。