diff --git a/operators/collect-into-array.md b/operators/collect-into-array.md
index 73152e51..1e7cc11b 100644
--- a/operators/collect-into-array.md
+++ b/operators/collect-into-array.md
@@ -2,6 +2,19 @@
 
 This creates an array using the expression between the square brackets.
 
+{% hint style="warning" %}
+
+_Note_ the placement of `|` when collecting. These two forms behave differently:
+
+```bash
+# Pipe then splat - creates separate context
+[.items | .[] | has("id")]
+
+# Splat directly on path - more common pattern
+[.items[] | has("id")]
+```
+
+{% endhint %}
 
 ## Collect empty
 Running
diff --git a/operators/create-collect-into-object.md b/operators/create-collect-into-object.md
index ff0c9cbe..02eb6ad5 100644
--- a/operators/create-collect-into-object.md
+++ b/operators/create-collect-into-object.md
@@ -2,6 +2,12 @@
 
 This is used to construct objects (or maps). This can be used against existing yaml, or to create fresh yaml documents.
 
+{% hint style="info" %}
+
+_Note_ for jq users: yq does not support shorthand object construction like `{name, version}`. Use the explicit form `{"name": .name, "version": .version}` or `pick(["name", "version"])` instead.
+
+{% endhint %}
+
 ## Collect empty object
 Running
 ```bash
diff --git a/operators/equals.md b/operators/equals.md
index ca5099b7..b4a37a8a 100644
--- a/operators/equals.md
+++ b/operators/equals.md
@@ -14,6 +14,26 @@ select(.a == .b)
 
 The not equals `!=` operator returns `false` if the LHS is equal to the RHS.
 
+{% hint style="info" %}
+
+_Note_ that the `!=` operator contains `!` which can trigger bash history expansion in interactive shells:
+
+```bash
+# May fail with: bash: !": event not found
+yq '.status != "healthy"' file.yaml
+```
+
+Workarounds:
+```bash
+# Use $'...' quoting
+yq $'.status != "healthy"' file.yaml
+
+# Or use | not instead of !=
+yq '.status == "healthy" | not' file.yaml
+```
+
+{% endhint %}
+
 ## Related Operators
 
 - comparison (`>=`, `<` etc) operators [here](https://mikefarah.gitbook.io/yq/operators/compare)
diff --git a/operators/select.md b/operators/select.md
index 2de0df52..b42f8a84 100644
--- a/operators/select.md
+++ b/operators/select.md
@@ -137,3 +137,37 @@ a:
   horse: dog
 ```
 
+## Piping select to a literal
+
+{% hint style="warning" %}
+
+_Note_ that piping `select()` to a literal value produces that literal for each match. When there are no matches, the literal is still produced once:
+
+Given a sample.yml file of:
+```yaml
+a: 1
+```
+then
+```bash
+yq '(.a | select(. == 999) | "matched") // "default"' sample.yml
+```
+will output
+```yaml
+matched
+```
+
+Since `.a` is `1`, not `999`, you might expect `"default"` here.
+
+The select does filter correctly when not followed by a literal:
+```bash
+yq '.a | select(. == 999)' sample.yml
+```
+will output nothing (empty).
+
+**Workaround**: Return the matched value itself, or use `with()`:
+```bash
+yq '(.a | select(. == 1)) // "default"' sample.yml
+```
+
+{% endhint %}
+
diff --git a/operators/slice-array.md b/operators/slice-array.md
index 9b89210b..3f954626 100644
--- a/operators/slice-array.md
+++ b/operators/slice-array.md
@@ -4,6 +4,22 @@ The slice array operator takes an array as input and returns a subarray. Like th
 
 You may leave out the first or second number, which will refer to the start or end of the array respectively.
 
+{% hint style="warning" %}
+
+_Note_ that slicing only works on arrays, not strings. Using slice syntax on a string (e.g., `.text | .[0:5]`) will return an empty result instead of a substring.
+
+For string slicing, use split/join or regex:
+
+```bash
+# Split into array, slice, rejoin
+yq '.text | split("") | .[0:5] | join("")'
+
+# Or use regex substitution
+yq '.text | sub("^(.{5}).*"; "${1}")'
+```
+
+{% endhint %}
+
 ## Slicing arrays
 Given a sample.yml file of:
 ```yaml