Added docs

pkg/yqlib/doc/operators/divide.md

@@ -1,3 +1,8 @@
+# Divide
+
+Divide behaves differently according to the type of the LHS:
+* strings: split by the divider
+* number: arithmetic division
 
 ## String split
 Given a sample.yml file of:

pkg/yqlib/doc/operators/filter.md

@@ -1,3 +1,7 @@
+# Filter
+
+Filters an array (or map values) by the expression given. Equivalent to doing `map(select(exp))`.
+
 
 ## Filter array
 Given a sample.yml file of:
@@ -16,3 +20,23 @@ will output
 - 2
 ```
 
+## Filter map values
+Given a sample.yml file of:
+```yaml
+c:
+  things: cool
+  frog: yes
+d:
+  things: hot
+  frog: false
+```
+then
+```bash
+yq 'filter(.things == "cool")' sample.yml
+```
+will output
+```yaml
+- things: cool
+  frog: yes
+```
+

pkg/yqlib/doc/operators/headers/divide.md

@@ -0,0 +1,5 @@
+# Divide
+
+Divide behaves differently according to the type of the LHS:
+* strings: split by the divider
+* number: arithmetic division

pkg/yqlib/doc/operators/headers/filter.md

@@ -0,0 +1,4 @@
+# Filter
+
+Filters an array (or map values) by the expression given. Equivalent to doing `map(select(exp))`.
+

pkg/yqlib/doc/operators/headers/modulo.md

@@ -0,0 +1,3 @@
+# Modulo
+
+Arithmetic modulo operator, returns the remainder from dividing two numbers.

pkg/yqlib/doc/operators/modulo.md

@@ -1,4 +1,6 @@
+# Modulo
 
+Arithmetic modulo operator, returns the remainder from dividing two numbers.
 ## Number modulo - int
 If the lhs and rhs are ints then the expression will be calculated with ints.
 

pkg/yqlib/operator_filter_test.go

@@ -13,6 +13,14 @@ var filterOperatorScenarios = []expressionScenario{
 			"D0, P[], (!!seq)::[1, 2]\n",
 		},
 	},
+	{
+		description: "Filter map values",
+		document:    `{c: {things: cool, frog: yes}, d: {things: hot, frog: false}}`,
+		expression:  `filter(.things == "cool")`,
+		expected: []string{
+			"D0, P[], (!!seq)::[{things: cool, frog: yes}]\n",
+		},
+	},
 	{
 		skipDoc:    true,
 		document:   `[1,2,3]`,