Add example of selecting object with keys

It is not very straight forward how to select objects by their attributes from an array. This example provides the basic use case of how to select some objects based key values.

diff --git a/docs/content/3.manual/manual.yml b/docs/content/3.manual/manual.yml
index 6522a6a07d1167600923b059747be8d9366cd4fe..a651373dffc8690e9941d61b86bbd4b660511d32 100644 (file)
--- a/docs/content/3.manual/manual.yml
+++ b/docs/content/3.manual/manual.yml
@@ -708,6 +708,9 @@ sections:
           - program: 'map(select(. >= 2))'
             input: '[1,5,3,0,7]'
             output: ['[5,3,7]']
+          - program: '.[] | select(.id == "second")'
+            input: '[{"id": "first", "val": 1}, {"id": "second", "val": 2}]'
+            output: '{"id": "second", "val": 2}'
 
 
       - title: "`arrays`, `objects`, `iterables`, `booleans`, `numbers`, `strings`, `nulls`, `values`, `scalars`"