Fix move plugin (#737)

* Fix move plugin

* Fix move plugin doc

Author: kirillov6

plugin/README.md

@@ -456,95 +456,8 @@ The resulting event could look like:
 [More details...](plugin/action/modify/README.md)
 ## move
 It moves fields to the target field in a certain mode.
-> In `allow` mode, the specified `fields` will be moved;
-> in `block` mode, the unspecified `fields` will be moved.
-
-### Examples
-```yaml
-pipelines:
-  example_pipeline:
-    ...
-    actions:
-    - type: move
-      mode: allow
-      target: other
-      fields:
-        - log.stream
-        - zone
-    ...
-```
-The original event:
-```json
-{
-  "service": "test",
-  "log": {
-    "level": "error",
-    "message": "error occurred",
-    "ts": "2023-10-30T13:35:33.638720813Z",
-    "stream": "stderr"
-  },
-  "zone": "z501"
-}
-```
-The resulting event:
-```json
-{
-  "service": "test",
-  "log": {
-    "level": "error",
-    "message": "error occurred",
-    "ts": "2023-10-30T13:35:33.638720813Z"
-  },
-  "other": {
-    "stream": "stderr",
-    "zone": "z501"
-  }
-}
-```
----
-```yaml
-pipelines:
-  example_pipeline:
-    ...
-    actions:
-    - type: move
-      mode: block
-      target: other
-      fields:
-        - log
-    ...
-```
-The original event:
-```json
-{
-  "service": "test",
-  "log": {
-    "level": "error",
-    "message": "error occurred",
-    "ts": "2023-10-30T13:35:33.638720813Z",
-    "stream": "stderr"
-  },
-  "zone": "z501",
-  "other": {
-    "user": "ivanivanov"
-  }
-}
-```
-The resulting event:
-```json
-{
-  "log": {
-    "level": "error",
-    "message": "error occurred",
-    "ts": "2023-10-30T13:35:33.638720813Z"
-  },
-  "other": {
-    "user": "ivanivanov",
-    "service": "test",
-    "zone": "z501"
-  }
-}
-```
+* In `allow` mode, the specified `fields` will be moved
+* In `block` mode, the unspecified `fields` will be moved
 
 [More details...](plugin/action/move/README.md)
 ## parse_es

plugin/action/README.md

@@ -299,95 +299,8 @@ The resulting event could look like:
 [More details...](plugin/action/modify/README.md)
 ## move
 It moves fields to the target field in a certain mode.
-> In `allow` mode, the specified `fields` will be moved;
-> in `block` mode, the unspecified `fields` will be moved.
-
-### Examples
-```yaml
-pipelines:
-  example_pipeline:
-    ...
-    actions:
-    - type: move
-      mode: allow
-      target: other
-      fields:
-        - log.stream
-        - zone
-    ...
-```
-The original event:
-```json
-{
-  "service": "test",
-  "log": {
-    "level": "error",
-    "message": "error occurred",
-    "ts": "2023-10-30T13:35:33.638720813Z",
-    "stream": "stderr"
-  },
-  "zone": "z501"
-}
-```
-The resulting event:
-```json
-{
-  "service": "test",
-  "log": {
-    "level": "error",
-    "message": "error occurred",
-    "ts": "2023-10-30T13:35:33.638720813Z"
-  },
-  "other": {
-    "stream": "stderr",
-    "zone": "z501"
-  }
-}
-```
----
-```yaml
-pipelines:
-  example_pipeline:
-    ...
-    actions:
-    - type: move
-      mode: block
-      target: other
-      fields:
-        - log
-    ...
-```
-The original event:
-```json
-{
-  "service": "test",
-  "log": {
-    "level": "error",
-    "message": "error occurred",
-    "ts": "2023-10-30T13:35:33.638720813Z",
-    "stream": "stderr"
-  },
-  "zone": "z501",
-  "other": {
-    "user": "ivanivanov"
-  }
-}
-```
-The resulting event:
-```json
-{
-  "log": {
-    "level": "error",
-    "message": "error occurred",
-    "ts": "2023-10-30T13:35:33.638720813Z"
-  },
-  "other": {
-    "user": "ivanivanov",
-    "service": "test",
-    "zone": "z501"
-  }
-}
-```
+* In `allow` mode, the specified `fields` will be moved
+* In `block` mode, the unspecified `fields` will be moved
 
 [More details...](plugin/action/move/README.md)
 ## parse_es

plugin/action/move/README.idoc.md

@@ -1,5 +1,8 @@
 # Move plugin
 @introduction
 
-### Config params
+## Examples
+@examples
+
+## Config params
 @config-params|description

plugin/action/move/README.md

@@ -1,9 +1,9 @@
 # Move plugin
 It moves fields to the target field in a certain mode.
-> In `allow` mode, the specified `fields` will be moved;
-> in `block` mode, the unspecified `fields` will be moved.
+* In `allow` mode, the specified `fields` will be moved
+* In `block` mode, the unspecified `fields` will be moved
 
-### Examples
+## Examples
 ```yaml
 pipelines:
   example_pipeline:
@@ -89,12 +89,60 @@ The resulting event:
   }
 }
 ```
+---
+```yaml
+pipelines:
+  example_pipeline:
+    ...
+    actions:
+    - type: move
+      mode: allow
+      target: other
+      fields:
+        - log.message
+        - error.message
+        - zone
+    ...
+```
+The original event:
+```json
+{
+  "service": "test",
+  "log": {
+    "message": "some log",
+    "ts": "2023-10-30T13:35:33.638720813Z"
+  },
+  "error": {
+    "code": 1,
+    "message": "error occurred"
+  },
+  "zone": "z501"
+}
+```
+The resulting event:
+```json
+{
+  "service": "test",
+  "log": {
+    "ts": "2023-10-30T13:35:33.638720813Z"
+  },
+  "error": {
+    "code": 1,
+  },
+  "other": {
+    "message": "error occurred",
+    "zone": "z501"
+  }
+}
+```
 
-### Config params
+## Config params
 **`fields`** *`[]cfg.FieldSelector`* *`required`* 
 
 The list of the fields to move.
-> In `block` mode, the maximum `fields` depth is 1.
+> 1. In `block` mode, the maximum `fields` depth is 1.
+> 2. If several fields have the same end of the path,
+> the last specified field will overwrite the previous ones.
 
 <br>
 
@@ -107,9 +155,9 @@ The mode of the moving. Available modes are one of: `allow|block`.
 **`target`** *`cfg.FieldSelector`* *`required`* 
 
 The target field of the moving.
-> If the `target` field is existing non-object field, it will be overwritten as object field.
-
-> In `block` mode, the maximum `target` depth is 1.
+> 1. In `block` mode, the maximum `target` depth is 1.
+> 2. If the `target` field is existing non-object field,
+> it will be overwritten as object field.
 
 <br>