content: Improve descriptions and signatures for collections functions

jmooring · jmooring · commit 535a3ff9132a · 2026-02-08T15:12:38.000-08:00
Closes gohugoio#3384
diff --git a/content/en/functions/collections/After.md b/content/en/functions/collections/After.md
@@ -1,13 +1,13 @@
 ---
 title: collections.After
-description: Slices an array to the items after the Nth item.
+description: Returns a slice containing the elements after the first N elements of the given slice.
 categories: []
 keywords: []
 params:
   functions_and_methods:
     aliases: [after]
-    returnType: any
-    signatures: [collections.After INDEX COLLECTION]
+    returnType: '[]any'
+    signatures: [collections.After N SLICE]
 aliases: [/functions/after]
 ---
 
diff --git a/content/en/functions/collections/Append.md b/content/en/functions/collections/Append.md
@@ -1,15 +1,15 @@
 ---
 title: collections.Append
-description: Appends one or more elements to a slice and returns the resulting slice.
+description: Returns a slice by adding one or more elements, or an entire second slice, to the end of the given slice.
 categories: []
 keywords: []
 params:
   functions_and_methods:
     aliases: [append]
-    returnType: any
-    signatures:
-      - collections.Append ELEMENT [ELEMENT...] COLLECTION
-      - collections.Append COLLECTION1 COLLECTION2
+    returnType: '[]any'
+    signatures: 
+      - collections.Append ELEMENT [ELEMENT...] SLICE
+      - collections.Append SLICE1 SLICE2
 aliases: [/functions/append]
 ---
 
diff --git a/content/en/functions/collections/Apply.md b/content/en/functions/collections/Apply.md
@@ -1,13 +1,13 @@
 ---
 title: collections.Apply
-description: Returns a new collection with each element transformed by the given function.
+description: Returns a slice by transforming each element of the given slice using a specific function and parameters.
 categories: []
 keywords: []
 params:
   functions_and_methods:
     aliases: [apply]
     returnType: '[]any'
-    signatures: [collections.Apply COLLECTION FUNCTION PARAM...]
+    signatures: [collections.Apply SLICE FUNCTION PARAM...]
 aliases: [/functions/apply]
 ---
 
diff --git a/content/en/functions/collections/Complement.md b/content/en/functions/collections/Complement.md
@@ -1,13 +1,13 @@
 ---
 title: collections.Complement
-description: Returns the elements of the last collection that are not in any of the others.
+description: Returns a slice by identifying elements in the last given slice that do not appear in any of the preceding slices.
 categories: []
 keywords: []
 params:
   functions_and_methods:
     aliases: [complement]
-    returnType: any
-    signatures: ['collections.Complement COLLECTION [COLLECTION...]']
+    returnType: '[]any'
+    signatures: ['collections.Complement SLICE [SLICE...]']
 aliases: [/functions/complement]
 ---
 
diff --git a/content/en/functions/collections/D.md b/content/en/functions/collections/D.md
@@ -1,6 +1,6 @@
 ---
 title: collections.D
-description:  Returns a sorted slice of unique random integers.
+description: Returns a sorted slice of unique random integers based on a given seed, count, and maximum value.
 categories: []
 keywords: [random]
 params:
diff --git a/content/en/functions/collections/Delimit.md b/content/en/functions/collections/Delimit.md
@@ -1,13 +1,13 @@
 ---
 title: collections.Delimit
-description: Loops through any array, slice, or map and returns a string of all the values separated by a delimiter.
+description: Returns a string by joining the values of the given slice or map with a delimiter.
 categories: []
 keywords: []
 params:
   functions_and_methods:
     aliases: [delimit]
     returnType: string
-    signatures: ['collections.Delimit COLLECTION DELIMITER [LAST]']
+    signatures: ['collections.Delimit SLICE|MAP DELIMITER [LAST]']
 aliases: [/functions/delimit]
 ---
 
diff --git a/content/en/functions/collections/Dictionary.md b/content/en/functions/collections/Dictionary.md
@@ -1,6 +1,6 @@
 ---
 title: collections.Dictionary
-description: Returns a map composed of the given key-value pairs.
+description: Returns a map created from the given key-value pairs.
 categories: []
 keywords: []
 params:
diff --git a/content/en/functions/collections/First.md b/content/en/functions/collections/First.md
@@ -1,13 +1,13 @@
 ---
 title: collections.First
-description: Returns the given collection, limited to the first N elements.
+description: Returns the first N elements of the given slice or string.
 categories: []
 keywords: []
 params:
   functions_and_methods:
     aliases: [first]
-    returnType: any
-    signatures: [collections.First N COLLECTION]
+    returnType: '[]any'
+    signatures: [collections.First N SLICE|STRING]
 aliases: [/functions/first]
 ---
 
diff --git a/content/en/functions/collections/Group.md b/content/en/functions/collections/Group.md
@@ -1,12 +1,12 @@
 ---
 title: collections.Group
-description: Groups the given page collection by the given key.
+description: Returns a map by grouping the given page collection (slice) by a specific key.
 categories: []
 keywords: []
 params:
   functions_and_methods:
     aliases: [group]
-    returnType: any
+    returnType: page.PageGroup
     signatures: [collections.Group KEY PAGES]
 aliases: [/functions/group]
 ---
diff --git a/content/en/functions/collections/In.md b/content/en/functions/collections/In.md
@@ -1,33 +1,21 @@
 ---
 title: collections.In
-description: Reports whether the given value is a member of the given set.
+description: Reports whether a value exists within the given slice or string.
 categories: []
 keywords: []
 params:
   functions_and_methods:
     aliases: [in]
     returnType: bool
-    signatures: [collections.In SET VALUE]
+    signatures: [collections.In SLICE|STRING VALUE]
 aliases: [/functions/in]
 ---
 
-The `SET` can be an [array](g), [slice](g), or [string](g).
-
 ```go-html-template
 {{ $s := slice "a" "b" "c" }}
 {{ in $s "b" }} → true
 ```
 
-```go-html-template
-{{ $s := slice 1 2 3 }}
-{{ in $s 2 }} → true
-```
-
-```go-html-template
-{{ $s := slice 1.11 2.22 3.33 }}
-{{ in $s 2.22 }} → true
-```
-
 ```go-html-template
 {{ $s := "abc" }}
 {{ in $s "b" }} → true
diff --git a/content/en/functions/collections/IndexFunction.md b/content/en/functions/collections/IndexFunction.md
@@ -1,13 +1,13 @@
 ---
 title: collections.Index
-description: Returns the object, element, or value associated with the given key or keys.
+description: Returns an element or value from the given slice or map at the specified key(s).
 categories: []
 keywords: []
 params:
   functions_and_methods:
     aliases: [index]
     returnType: any
-    signatures: [collections.Index COLLECTION KEY...]
+    signatures: [collections.Index SLICE|MAP KEY...]
 aliases: [/functions/index,/functions/index-function]
 ---
 
diff --git a/content/en/functions/collections/Intersect.md b/content/en/functions/collections/Intersect.md
@@ -1,13 +1,13 @@
 ---
 title: collections.Intersect
-description: Returns the common elements of two arrays or slices, in the same order as the first array.
+description: Returns a slice containing the common elements found in two given slices, in the same order as the first slice.
 categories: []
 keywords: []
 params:
   functions_and_methods:
     aliases: [intersect]
-    returnType: any
-    signatures: [collections.Intersect SET1 SET2]
+    returnType: '[]any'
+    signatures: [collections.Intersect SLICE1 SLICE2]
 aliases: [/functions/intersect]
 ---
 
diff --git a/content/en/functions/collections/IsSet.md b/content/en/functions/collections/IsSet.md
@@ -1,13 +1,13 @@
 ---
 title: collections.IsSet
-description: Reports whether the key exists within the collection.
+description: Reports whether a specific key or index exists in the given map or slice.
 categories: []
 keywords: []
 params:
   functions_and_methods:
     aliases: [isset]
     returnType: bool
-    signatures: [collections.IsSet COLLECTION KEY]
+    signatures: [collections.IsSet MAP|SLICE KEY|INDEX]
 aliases: [/functions/isset]
 ---
 
diff --git a/content/en/functions/collections/KeyVals.md b/content/en/functions/collections/KeyVals.md
@@ -1,6 +1,6 @@
 ---
 title: collections.KeyVals
-description: Returns a KeyVals struct.
+description: Returns a KeyVals struct by pairing a given key and values.
 categories: []
 keywords: []
 params:
diff --git a/content/en/functions/collections/Last.md b/content/en/functions/collections/Last.md
@@ -1,13 +1,13 @@
 ---
 title: collections.Last
-description: Returns the given collection, limited to the last N elements.
+description: Returns the last N elements of the given slice or string.
 categories: []
 keywords: []
 params:
   functions_and_methods:
     aliases: [last]
-    returnType: any
-    signatures: [collections.Last N COLLECTION]
+    returnType: 'any'
+    signatures: [collections.Last N SLICE|STRING]
 aliases: [/functions/last]
 ---
 
diff --git a/content/en/functions/collections/Merge.md b/content/en/functions/collections/Merge.md
@@ -1,6 +1,6 @@
 ---
 title: collections.Merge
-description: Returns the result of merging two or more maps.
+description: Returns a map by combining two or more given maps.
 categories: []
 keywords: []
 params:
diff --git a/content/en/functions/collections/NewScratch.md b/content/en/functions/collections/NewScratch.md
@@ -7,7 +7,7 @@ params:
   functions_and_methods:
     aliases: [newScratch]
     returnType: maps.Scratch
-    signatures: [collections.NewScratch ]
+    signatures: [collections.NewScratch]
 ---
 
 Use the `collections.NewScratch` function to create a locally scoped [scratch pad](g) to store and manipulate data. To create a scratch pad with a different [scope](g), refer to the [scope](#scope) section below.
diff --git a/content/en/functions/collections/Querify.md b/content/en/functions/collections/Querify.md
@@ -1,13 +1,13 @@
 ---
 title: collections.Querify
-description: Returns a URL query string composed of the given key-value pairs, encoded and sorted by key.
+description: Returns a URL query string from the given map, slice, or sequence of key-value pairs.
 categories: []
 keywords: []
 params:
   functions_and_methods:
     aliases: [querify]
     returnType: string
-    signatures: ['collections.Querify [VALUE...]']
+    signatures: [collections.Querify MAP|SLICE|KEY VALUE...]
 aliases: [/functions/querify]
 ---
 
diff --git a/content/en/functions/collections/Reverse.md b/content/en/functions/collections/Reverse.md
@@ -1,13 +1,13 @@
 ---
 title: collections.Reverse
-description: Reverses the order of a collection.
+description: Returns a slice by reversing the order of elements in the given slice.
 categories: []
 keywords: []
 params:
   functions_and_methods:
     aliases: []
-    returnType: any
-    signatures: [collections.Reverse COLLECTION]
+    returnType: '[]any'
+    signatures: [collections.Reverse SLICE]
 aliases: [/functions/collections.reverse]
 ---
 
diff --git a/content/en/functions/collections/Seq.md b/content/en/functions/collections/Seq.md
@@ -1,6 +1,6 @@
 ---
 title: collections.Seq
-description: Returns a slice of integers.
+description: Returns a slice of integers starting from 1 or a given value, incrementing by 1 or a given value, and ending at a given value.
 categories: []
 keywords: []
 params:
diff --git a/content/en/functions/collections/Shuffle.md b/content/en/functions/collections/Shuffle.md
@@ -1,13 +1,13 @@
 ---
 title: collections.Shuffle
-description: Returns a random permutation of a given array or slice.
+description: Returns a slice by randomizing the element order of the given slice.
 categories: []
 keywords: [random]
 params:
   functions_and_methods:
     aliases: [shuffle]
-    returnType: any
-    signatures: [collections.Shuffle COLLECTION]
+    returnType: '[]any'
+    signatures: [collections.Shuffle SLICE]
 aliases: [/functions/shuffle]
 ---
 
diff --git a/content/en/functions/collections/Slice.md b/content/en/functions/collections/Slice.md
@@ -1,12 +1,12 @@
 ---
 title: collections.Slice
-description: Returns a slice composed of the given values.
+description: Returns a slice created from the given values.
 categories: []
 keywords: []
 params:
   functions_and_methods:
     aliases: [slice]
-    returnType: any
+    returnType: '[]any'
     signatures: ['collections.Slice [VALUE...]']
 aliases: [/functions/slice]
 ---
diff --git a/content/en/functions/collections/Sort.md b/content/en/functions/collections/Sort.md
@@ -1,13 +1,13 @@
 ---
 title: collections.Sort
-description: Sorts slices, maps, and page collections.
+description: Returns a sorted map or slice by reordering the given collection by a key and order.
 categories: []
 keywords: []
 params:
   functions_and_methods:
     aliases: [sort]
     returnType: any
-    signatures: ['collections.Sort COLLECTION [KEY] [ORDER]']
+    signatures: ['collections.Sort MAP|SLICE [KEY] [ORDER]']
 aliases: [/functions/sort]
 ---
 
diff --git a/content/en/functions/collections/SymDiff.md b/content/en/functions/collections/SymDiff.md
@@ -1,13 +1,13 @@
 ---
 title: collections.SymDiff
-description: Returns the symmetric difference of two collections.
+description: Returns a slice containing the symmetric difference of two given slices.
 categories: []
 keywords: []
 params:
   functions_and_methods:
     aliases: [symdiff]
-    returnType: any
-    signatures: [COLLECTION | collections.SymDiff COLLECTION]
+    returnType: '[]any'
+    signatures: [SLICE1 | collections.SymDiff SLICE2]
 aliases: [/functions/symdiff]
 ---
 
diff --git a/content/en/functions/collections/Union.md b/content/en/functions/collections/Union.md
diff --git a/content/en/functions/collections/Uniq.md b/content/en/functions/collections/Uniq.md
diff --git a/content/en/functions/collections/Where.md b/content/en/functions/collections/Where.md
