-
Notifications
You must be signed in to change notification settings - Fork 1.7k
Description
Many key jq language features are not very evident in the manual. One that just tripped me up was the operator precedence (,vs |), but there are already a bunch of open issues here requesting better documentation of various langauge features, including this one. Apparently the community here has decided such clear semantics should be documented in the Wiki rather than the manual, which seems to prefer a more mystical and indirect approach to explanation. The Wiki itself has some header mentioning such reasons, which no doubt could be debated forever.
In the meanwhile, it would be much easier for noobs (or infrequent users) to use jq if the "official" manual had a link to the wiki. You might even want to add the title "jq Language Reference" to the Wiki (and maybe a few other key search terms) to increase findability.
This should be an easy action with enormous time savings (and maybe even more jq users).