
# Selector Operators

Operators combine atoms into compound expressions.

| Operator | Meaning |
|----------|---------|
| `+` | AND — documents matching **both** sides |
| `\|` | OR — documents matching **either** side |
| `-` | NOT — documents matching the left side but **not** the right |

## AND (`+`)

```
#api +status:published
```

## OR (`|`)

```
#api |#sdk
```

## NOT (`-`)

```
#engineering -#deprecated
```

## Grouping (`()`)

Parentheses control evaluation order. Use them whenever you mix operators, rather than relying on precedence:

```
(#api |#sdk) +status:published
```

## `&` is not valid

Older docs used `&` for intersection. It no longer works. `ctx` rejects it with `INVALID_SELECTOR`. Use `+` instead.
