diff --git a/pkg/yqlib/doc/Boolean Operators.md b/pkg/yqlib/doc/Boolean Operators.md
index 198ab8da..daebec08 100644
--- a/pkg/yqlib/doc/Boolean Operators.md	
+++ b/pkg/yqlib/doc/Boolean Operators.md	
@@ -1,157 +1,44 @@
 The `or` and `and` operators take two parameters and return a boolean result. These are most commonly used with the `select` operator to filter particular nodes.
 ## Examples
-### Update node to be the child value
-Given a sample.yml file of:
-```yaml
-a:
-  b:
-    g: foof
-```
-then
+### OR example
+Running
 ```bash
-yq eval '.a |= .b' sample.yml
+yq eval --null-input 'true or false'
 ```
 will output
 ```yaml
-a:
-  g: foof
+true
 ```
 
-### Update node to be the sibling value
-Given a sample.yml file of:
-```yaml
-a:
-  b: child
-b: sibling
-```
-then
+### AND example
+Running
 ```bash
-yq eval '.a = .b' sample.yml
+yq eval --null-input 'true and false'
 ```
 will output
 ```yaml
-a: sibling
-b: sibling
+false
 ```
 
-### Updated multiple paths
+### Matching nodes with select, equals and or
 Given a sample.yml file of:
 ```yaml
-a: fieldA
-b: fieldB
-c: fieldC
+- a: bird
+  b: dog
+- a: frog
+  b: bird
+- a: cat
+  b: fly
 ```
 then
 ```bash
-yq eval '(.a, .c) |= "potatoe"' sample.yml
+yq eval '.[] | select(.a == "cat" or .b == "dog")' sample.yml
 ```
 will output
 ```yaml
-a: potatoe
-b: fieldB
-c: potatoe
-```
-
-### Update string value
-Given a sample.yml file of:
-```yaml
-a:
-  b: apple
-```
-then
-```bash
-yq eval '.a.b = "frog"' sample.yml
-```
-will output
-```yaml
-a:
-  b: frog
-```
-
-### Update string value via |=
-Note there is no difference between `=` and `|=` when the RHS is a scalar
-
-Given a sample.yml file of:
-```yaml
-a:
-  b: apple
-```
-then
-```bash
-yq eval '.a.b |= "frog"' sample.yml
-```
-will output
-```yaml
-a:
-  b: frog
-```
-
-### Update selected results
-Given a sample.yml file of:
-```yaml
-a:
-  b: apple
-  c: cactus
-```
-then
-```bash
-yq eval '.a[] | select(. == "apple") |= "frog"' sample.yml
-```
-will output
-```yaml
-a:
-  b: frog
-  c: cactus
-```
-
-### Update array values
-Given a sample.yml file of:
-```yaml
-- candy
-- apple
-- sandy
-```
-then
-```bash
-yq eval '.[] | select(. == "*andy") |= "bogs"' sample.yml
-```
-will output
-```yaml
-- bogs
-- apple
-- bogs
-```
-
-### Update empty object
-Given a sample.yml file of:
-```yaml
-'': null
-```
-then
-```bash
-yq eval '.a.b |= "bogs"' sample.yml
-```
-will output
-```yaml
-'': null
-a:
-  b: bogs
-```
-
-### Update empty object and array
-Given a sample.yml file of:
-```yaml
-'': null
-```
-then
-```bash
-yq eval '.a.b[0] |= "bogs"' sample.yml
-```
-will output
-```yaml
-'': null
-a:
-  b:
-    - bogs
+a: bird
+b: dog
+a: cat
+b: fly
 ```
 
diff --git a/pkg/yqlib/operator_booleans_test.go b/pkg/yqlib/operator_booleans_test.go
index 12e65c51..29275216 100644
--- a/pkg/yqlib/operator_booleans_test.go
+++ b/pkg/yqlib/operator_booleans_test.go
@@ -52,5 +52,5 @@ func TestBooleanOperatorScenarios(t *testing.T) {
 	for _, tt := range booleanOperatorScenarios {
 		testScenario(t, &tt)
 	}
-	documentScenarios(t, "Boolean Operators", assignOperatorScenarios)
+	documentScenarios(t, "Boolean Operators", booleanOperatorScenarios)
 }