apache / apache/lucene

Query syntax description not precise enough about boolean operators (AND, OR) [LUCENE-3674]

Open
#4,748 2 comments 0 reactions 0 assignees View on GitHub
affects-version:3.2 legacy-jira-priority:Major type:bug website
Dominant language
Java
Stars
3.6k
Forks
1.4k
Avg merge
2d 11h
Merged PRs (30d)
88

Description

The description of the syntax does not mention that boolean precedence with AND/OR does not happen at all. One assumes that it is handled the way boolean operations are handled like anywhere else. I have elaborated this in the [mailing list](http://mail-archives.apache.org/mod_mbox/lucene-java-user/201201.mbox/%3C20120103152903.35670%40gmx.net%3E).

Please make prominent that there is no precedence and users have to group explicitly to achieve precedence.

---
Migrated from [LUCENE-3674](https://issues.apache.org/jira/browse/LUCENE-3674) by Michael Osipov (@michael-o)
Linked issues:
- #4749

Contributor guide

Open the contributing guide

Research direction

Start by locating Lucene's query syntax documentation and review the linked mailing-list discussion for the intended explanation. Done means the documentation prominently states that AND/OR have no precedence and that users must group expressions explicitly to achieve precedence.

Written by the indexing model from the issue text.

Assessment

Tech stack
java
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.