jq: clarify descriptions (#1361)

pages/common/jq.md

@@ -2,26 +2,26 @@
 
 > A lightweight and flexible command-line JSON processor.
 
-- Output JSON file:
+- Output a JSON file, in pretty-print format:
 
 `cat {{file}} | jq`
 
-- Output all elements from JSON array in file, or all key-value pairs from JSON objects in file:
+- Output all elements from arrays (or all key-value pairs from objects) in a JSON file:
 
 `cat {{file}} | jq .[]`
 
-- Read JSON objects from file, into array, and output (inverse of `jq .[]`):
+- Read JSON objects from a file into an array, and output it (inverse of `jq .[]`):
 
 `cat {{file}} | jq --slurp`
 
-- Output first element in JSON file:
+- Output the first element in a JSON file:
 
 `cat {{file}} | jq .[0]`
 
-- Output "key" of first element in JSON file:
+- Output the value of a given key of the first element in a JSON file:
 
-`cat {{file}} | jq .[0].{{key}}`
+`cat {{file}} | jq .[0].{{key_name}}`
 
-- Output "key" of each element in JSON file:
+- Output the value of a given key of each element in a JSON file:
 
-`cat {{file}} | jq 'map(.{{key}})'`
+`cat {{file}} | jq 'map(.{{key_name}})'`