Documentation clarification suggestions

diff --git a/docs/content/3.manual/manual.yml b/docs/content/3.manual/manual.yml
index 3e43cdbce944d37bf3e68d47506314c8a0386e7d..4dd9d3acebe43589888ec062e08f703ba594fd22 100644 (file)
--- a/docs/content/3.manual/manual.yml
+++ b/docs/content/3.manual/manual.yml
@@ -723,7 +723,7 @@ sections:
       - title: "`in`"
         body: |
 
-          The builtin function `in` returns the input key is in the
+          The builtin function `in` returns whether or not the input key is in the
           given object, or the input index corresponds to an element
           in the given array. It is, essentially, an inversed version
           of `has`.
@@ -740,7 +740,7 @@ sections:
         body: |
 
           For any filter `x`, `map(x)` will run that filter for each
-          element of the input array, and produce the outputs a new
+          element of the input array, and return the outputs in a new
           array. `map(.+1)` will increment each element of an array of numbers.
 
           Similarly, `map_values(x)` will run that filter for each element,
@@ -762,8 +762,8 @@ sections:
         body: |
 
           Outputs array representations of the given path expression
-          in `.`.  The outputs are arrays of strings (keys in objects0
-          and/or numbers (array indices.
+          in `.`.  The outputs are arrays of strings (object keys)
+          and/or numbers (array indices).
 
           Path expressions are jq expressions like `.a`, but also `.[]`.
           There are two types of path expressions: ones that can match

diff --git a/docs/content/3.manual/v1.5/manual.yml b/docs/content/3.manual/v1.5/manual.yml
index 1b37e79924cf67091d33cecec72303fa332f6009..647048bbd1f3ad43209ddbe7989df8447f4623f8 100644 (file)
--- a/docs/content/3.manual/v1.5/manual.yml
+++ b/docs/content/3.manual/v1.5/manual.yml
@@ -711,7 +711,7 @@ sections:
       - title: "`in`"
         body: |
 
-          The builtin function `in` returns the input key is in the
+          The builtin function `in` returns whether or not the input key is in the
           given object, or the input index corresponds to an element
           in the given array. It is, essentially, an inversed version
           of `has`.
@@ -728,8 +728,8 @@ sections:
         body: |
 
           Outputs array representations of the given path expression
-          in `.`.  The outputs are arrays of strings (keys in objects0
-          and/or numbers (array indices.
+          in `.`.  The outputs are arrays of strings (object keys)
+          and/or numbers (array indices).
 
           Path expressions are jq expressions like `.a`, but also `.[]`.
           There are two types of path expressions: ones that can match
@@ -866,7 +866,7 @@ sections:
         body: |
 
           For any filter `x`, `map(x)` will run that filter for each
-          element of the input array, and produce the outputs a new
+          element of the input array, and return the outputs in a new
           array. `map(.+1)` will increment each element of an array of numbers.
 
           Similarly, `map_values(x)` will run that filter for each element,