Merge commit '81689af79901f0cdaff765cda6322dd4a9a7ccb3'

docs/content/en/functions/sort.md

@@ -22,42 +22,42 @@ aliases: []
 A sorted array of map values will be returned with the keys eliminated. There are two optional arguments: `sortByField` and `sortAsc`. If left blank, sort will sort by keys (for maps) in ascending order as its default behavior.
 
 ```
-+++
-keywords: [ "tag3", "tag1", "tag2" ]
-+++
+---
+tags: ["tag3", "tag1", "tag2"]
+---
 
 // Site config
 +++
 [params.authors]
-  [params.authors.Derek]
-    "firstName"  = "Derek"
-    "lastName"   = "Perkins"
   [params.authors.Joe]
-    "firstName"  = "Joe"
-    "lastName"   = "Bergevin"
+    firstName = "Joe"
+    lastName  = "Bergevin"
+  [params.authors.Derek]
+    firstName = "Derek"
+    lastName  = "Perkins"
   [params.authors.Tanner]
-    "firstName"  = "Tanner"
-    "lastName"   = "Linsley"
+    firstName = "Tanner"
+    lastName  = "Linsley"
 +++
 ```
 
 ```
-// Use default sort options - sort by key / ascending
+// Sort by value, ascending (default for lists)
 Tags: {{ range sort .Params.tags }}{{ . }} {{ end }}
 
 → Outputs Tags: tag1 tag2 tag3
 
-// Sort by value / descending
+// Sort by value, descending
 Tags: {{ range sort .Params.tags "value" "desc" }}{{ . }} {{ end }}
 
 → Outputs Tags: tag3 tag2 tag1
 
-// Use default sort options - sort by value / descending
+// Sort by key, ascending (default for maps)
 Authors: {{ range sort .Site.Params.authors }}{{ .firstName }} {{ end }}
 
 → Outputs Authors: Derek Joe Tanner
 
-// Use default sort options - sort by value / descending
+// Sort by field, descending
 Authors: {{ range sort .Site.Params.authors "lastName" "desc" }}{{ .lastName }} {{ end }}
 
 → Outputs Authors: Perkins Linsley Bergevin