Merge commit 'b9bd35d72e14932fb6588ff62b90cddef0a060fc' as 'docs'

docs/content/en/functions/merge.md

@@ -0,0 +1,40 @@
+---
+title: merge
+description: "`merge` deep merges two maps and returns the resulting map."
+date: 2019-08-08
+categories: [functions]
+menu:
+  docs:
+    parent: "functions"
+keywords: [dictionary]
+signature: ["$params :=  merge $default_params $user_params"]
+workson: []
+hugoversion: "0.56.0"
+relatedfuncs: [dict, append, reflect.IsMap, reflect.IsSlice]
+aliases: []
+---
+
+An example merging two maps.
+
+```go-html-template
+{{ $default_params := dict "color" "blue" "width" "50%" "height" "25%" }}
+{{ $user_params := dict "color" "red" "extra" (dict "duration" 2) }}
+{{ $params := merge $default_params $user_params }}
+```
+
+Resulting __$params__:
+
+```
+"color": "red"
+"extra":
+  "duration": 2
+"height": "25%"
+"icon": "mail"
+"width": "50%"
+```
+
+{{% note %}}
+  Regardless of depth, merging only applies to maps. For slices, use [append]({{< ref "functions/append" >}})
+{{% /note %}}
+
+