-
Notifications
You must be signed in to change notification settings - Fork 20
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Clarify wrapping filter expressions in parentheses #499
Conversation
Make it clear that this is not required, unlike in the original JSONPath article. Also, avoid using such parentheses in examples for consistency.
draft-ietf-jsonpath-base.md
Outdated
@@ -1173,6 +1173,11 @@ They have the normal semantics of Boolean algebra and obey its laws | |||
(see, for example, {{BOOLEAN-LAWS}}). | |||
Parentheses MAY be used within `logical-expr` for grouping. | |||
|
|||
It is not required that `logical-expr` consist of | |||
a parenthesized expression (which was required in {{JSONPath-orig}}), | |||
although it can be and the semantics are the same |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
comma after "be"?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Yes, I think that works well. Added.
@@ -1173,6 +1173,11 @@ They have the normal semantics of Boolean algebra and obey its laws | |||
(see, for example, {{BOOLEAN-LAWS}}). | |||
Parentheses MAY be used within `logical-expr` for grouping. | |||
|
|||
It is not required that `logical-expr` consist of |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We now have removed all examples that actually show what is discussed here?
(We know what it is, but readers may not.)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Yes, I was a little concerned about that too, so I've added a specific example near the top of the filter example table.
Make it clear that this is not required, unlike in the original JSONPath article. Also, avoid using such parentheses in examples for consistency.