Document how ADJ, NEAR, SAME, WITH should work

[metasj]

Share descriptions of how this should work, with test cases + expected outputs, a prereq to thorough testing. Nupur, you may have a good writeup of this already.

Implementations of these adjacency words differ. All have a default distance. NEAR : within some # of words in any direction. WITH can mean within a # of words, in the order specified. ADJ : next to in any direction, or in the order specified. If ADJ takes a number it replaces either NEAR or WITH? SAME : often "in the same paragraph".

[metasj]

On the current site we support both inline adjacency operators (nearN, adjN, &c) and a dropdown selector that applies some default version of adjacency to the entire string.

Currently the following are equivalent:

• "mobile near0 phone" || "mobile phone" using the NEAR dropdown
• "mobile with15 phone" || "mobile phone" using the WITH dropdown
• "mobile nearN phone" || "mobile withN phone"

Known issues:

• You cannot use the operators inline with no number. "mobile near phone" returns no results.
• Special characters in search are currently broken, including quotations, so we can't test w quoted strings.

[metasj]

Details from a Thomson tool: https://images.webofknowledge.com/images/help/TCT/search_fundamentals.htm

Details from a similar tool, w/tests (but not specifying default distance): http://www.acclaimip.com/near-and-adj-proximity-operators/

[joeltg]

I think these are documented on the Help page at https://www.priorartarchive.org/help - all operators have specific meanings that map onto the Elasticsearch Query DSL

[slifty]

@metasj based on @joeltg's observation, is this task complete or should we re-scope to include work that is needed.