Update search3.md#246
Conversation
rules for `query` parameters
✅ Deploy Preview for opensubsonic ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
There was a problem hiding this comment.
Pull request overview
This PR updates the search3 endpoint documentation to clarify OpenSubsonic server requirements for how the query parameter is parsed and matched, based on the discussion in #195.
Changes:
- Adds a new OpenSubsonic warning block specifying required
queryparsing/matching rules (per-word matching, grouping, and matching behavior). - Documents grouping behavior via
+or quotes and how grouped vs ungrouped words should match.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
|
Written like that you prevent servers to use fuzzy search or any improvement to their search algo. |
|
I've implemented the first round, i'll put more information around fuzzy things as well after. right now i'm also including search* "search term"* and a few others so will need to extend this |
|
I don't think I agree with forcing this over all server implementations, specially defining which fields to search on. |
by default allows you to provide other options
|
I've added "by default" in the rules and rewritten it a bit looser. This is all based on demo.subsonic.org's behaviour as the "subsonic way". I think from here there also needs to be a new search endpoint that allows heavier customisation, rules and objects to match which i've raised before. There needs to be definition of what the standard is otherwise search3 means anything you want which isn't helpful if we're all going to implement the same thing. I don't care what the standard actually is but we need to do the same things and a clarification of some kind will set that requirement. |
|
Regarding search fields i think there needs to be the subsonic way then the wild way. A new parameter like anywhere would let you open up the query past the defaults Alternatively MusicBrainz allows query prefixing which is also a possible alternative but i like it less as it's a significant change to implement What i'm trying to push for is some kind of consensus on what to do so it's clear. |
rules for
queryparameters as discussed in #195