Better recursive decent docs

pkg/yqlib/doc/Recursive Descent (Glob).md

@@ -33,6 +33,8 @@ frog
 ```
 
 ## Recursively find nodes with keys
+Note that this example has wrapped the expression in `[]` to show that there are two matches returned. You do not have to wrap in `[]` in your path expression.
+
 Given a sample.yml file of:
 ```yaml
 a:
@@ -43,15 +45,15 @@ a:
 ```
 then
 ```bash
-yq eval '.. | select(has("name"))' sample.yml
+yq eval '[.. | select(has("name"))]' sample.yml
 ```
 will output
 ```yaml
-name: frog
+- name: frog
   b:
     name: blog
     age: 12
-name: blog
+- name: blog
   age: 12
 ```
 

pkg/yqlib/operator_recursive_descent_test.go

@@ -64,11 +64,11 @@ var recursiveDescentOperatorScenarios = []expressionScenario{
 	},
 	{
 		description: "Recursively find nodes with keys",
+		subdescription: "Note that this example has wrapped the expression in `[]` to show that there are two matches returned. You do not have to wrap in `[]` in your path expression.",
 		document:    `{a: {name: frog, b: {name: blog, age: 12}}}`,
-		expression:  `.. | select(has("name"))`,
+		expression:  `[.. | select(has("name"))]`,
 		expected: []string{
-			"D0, P[a], (!!map)::{name: frog, b: {name: blog, age: 12}}\n",
-			"D0, P[a b], (!!map)::{name: blog, age: 12}\n",
+			"D0, P[a], (!!seq)::- {name: frog, b: {name: blog, age: 12}}\n- {name: blog, age: 12}\n",
 		},
 	},
 	{
@@ -233,5 +233,5 @@ func TestRecursiveDescentOperatorScenarios(t *testing.T) {
 	for _, tt := range recursiveDescentOperatorScenarios {
 		testScenario(t, &tt)
 	}
-	documentScenarios(t, "Recursive Descent", recursiveDescentOperatorScenarios)
+	documentScenarios(t, "Recursive Descent (Glob)", recursiveDescentOperatorScenarios)
 }