Operators

Operators combine atoms into compound expressions.

Union (+ or |)

Returns documents matching either side.

tag:#api + tag:#sdk
tag:#api | tag:#sdk      # equivalent

Intersection (&)

Returns documents matching both sides.

tag:#api & status:published

Difference (-)

Returns documents matching the left side but not the right side.

tag:#engineering - tag:#deprecated

Grouping (())

Parentheses control evaluation order.

(tag:#api | tag:#sdk) & status:published

Without parentheses, & binds tighter than +/|:

tag:#api + tag:#sdk & status:published
# equivalent to: tag:#api + (tag:#sdk & status:published)

Precedence

From highest to lowest:

1. () — Grouping
2. &, - — Intersection, Difference
3. +, | — Union