Search: fuzzy checkbox UI element

[astrojuanlu]

I searched for "context" but started getting results for "content", which was confusing.

[stsewd]

This is because our project has the fuzzy search flag enabled. We aren't checking for spelling errors, we are just doing a fuzzy search if you search a "single term". You can use "context" to get an exact search.

[astrojuanlu]

Thanks for the explanation on the root cause @stsewd ! However I wonder if this is good UX. I was confused, and so extrapolating from N=1, I wonder if more people would get confused.

[stsewd]

This was actually so people aren't frustrated if they made a typo or don't know the exact word. This is controlled via https://github.com/readthedocs/readthedocs.org/blob/f0da2a478705c794ce046d67a3eededf5595fd33/readthedocs/search/faceted_search.py#L178-L184 https://www.elastic.co/guide/en/elasticsearch/reference/current/common-options.html#fuzziness

We were also exploring into having a UI for displaying the search options. So, not sure, personalty I like the default fuzzy and prefix search, and use " if I need to search something specific (rarely I need to use quotes really)

[astrojuanlu]

I see how users might get frustrated if they made a typo, or if they used a different spelling (British vs American for example). So doing the fuzzy search is a great addition.

However, for cases in which the user didn't make a typo:

1. It is weird to see matches of words you're not interested in, and
2. There is no way to discover how to look for an exact match (yes, using double quotes)

So, I think it would be cool to have an admonition on top of the search page saying something like

Performing a fuzzy match on the backend, use "{term}" to do an exact match. Read more about the search syntax and how Read the Docs enhances search on your project.

[stsewd]

+1 on adding that admonition in our search extension

[stsewd]

We could also inject that message in search page without requiring our search extension, but not sure about changing that content in behalf of users.

[humitos]

I think search.html vs modal solves different UX issues --and both are good! 👍🏼

Adding it on the modal communicates the extra options before the user searches for a term. Also, if the user doesn't hit enter on that modal, they will never see the search.html page.

On the search.html works for the case that the user searches for content and then realize that it's showing context results as well, so they want to force it to be exact after searching for the term.

In any case, I think it would also be good to have an icon or something in the search box in the left (in our theme) that can hover/click and go directly to the documentation.

[nienn]

Performing a fuzzy match on the backend, use "{term}" to do an exact match. Read more about the search syntax and how Read the Docs enhances search on your project.

Adding info here is a good idea!
I would also like to see the words that are being searched appear somewhere.
The admonition is a great but takes long to read. Adding the searched words, besides the admonition, could be a chance to show the same idea in a visual manner and in a more intuitive way.

Maybe each word could even have an (x) nearby that the user could click to exclude that word?

[astrojuanlu]

I don't know how the fuzzy search works, but maybe we don't have the list of "extra words" that are being searched? I'll let others clarify that though.

[stsewd]

@astrojuanlu yeah, not sure if we have the list (but we can extract them from the matches), but we also do a prefix search (words that start with the current search), so the list could get pretty large.

[nienn]

but we also do a prefix search (words that start with the current search), so the list could get pretty large.

We don't need to display the full list, just the 1st N search terms.

[humitos]

This would be a really good UI element (Fuzzy checkbox) in the search as you type addon. I'm moving this issue over there.

Performing a fuzzy match on the backend, use "{term}" to do an exact match. Read more about the search syntax and how Read the Docs enhances search on your project.

This is tracked in #33