Usersnap Feedback - Is it premature to add info about faceted search? Or perhaps it will be a [...]

[ascott]

Sender: pscully@clearviewconsultingllc.com Comment: Is it premature to add info about faceted search? Or perhaps it will be a separate help topic? Open #366 in Usersnap Dashboard

Download original image

Browser: Chrome 74 (Windows 10) Referer: https://ppedia-stage.herokuapp.com/# Screen size: 1920 x 1200 Browser size: 1920 x 1089

Powered by usersnap.com

[jesicarson]

We shouldn't add it yet, but it can certainly be drafted! @ascott ill work on that and post the text here and ideally you can add it to the help menu when faceted search goes live.

[jesicarson]

Draft here @plscully @scottofletcher look ok? @ascott can you use red code font to the custom syntax too?

How do I search for content?

Homepage: By default, the homepage displays all of the entries on the website, including a curated set of featured content. Also on the homepage, explore the interactive map to find content by location, or use the search filters under the Cases tab to narrow results.

Search Filters: Search filters are available on the homepage under the Cases tab. These filters can apply to all cases. They can also further refine an existing keyword search.

Search Bar: Use the search bar at the top of any page to conduct a site-wide search using one or more keywords. Once your search results are displayed, sort the results by content type such as cases, methods or organizations.

Advanced Keyword Search Syntax: AND: bicycle and rally (this is the default, so the same as bicycle rally) will return items which match both words

OR: bicycle or rally will match items with either or both words

NOT: bicycle not rally will match items which contain bicycle, but only if they do not also contain rally

QUOTES: womens rights will return items that have womens followed by rights

PARENTHESES: (bicycle or rally) and (womens rights and UK) will will group logical operations inside the parentheses as a group before applying the operators joining groups

[plscully]

@jesicarson This looks good to me. One small thing is that you may want to add the actual quote marks around "womens rights"

[scottofletcher]

I'm still confused about the advanced key word search. it says that 'bicycle and rally' "is the default, so the same as bicycle rally", so why add the and in the first place? my understanding of boolean searches was that searching for bicycle and rally would only return results with one or both words, while bicycle AND rally would return results with both (the word and being capitalized). also, please see my copy edits (#610) and review the comments. there are more updates. for example the last sentence above reads:

(bicycle or rally) and (womens rights and UK) will will group logical operations inside the parentheses as a group before applying the operators joining groups

I think it makes more sense as:

(bicycle or rally) and (womens rights and UK) will group logical operations inside the parentheses before applying the operators joining the two search items

[jesicarson]

The and is not case sensitive and including it as its own option helps explain its use in the parentheses option. Will try to review all the copy after the major bugs and design changes are dealt with. I think our focus now will be adjusting copy edits that make no sense (ie the teaching page referencing nonexistent blog posts). that said it's super useful to have these docs for when things calm down and we can spend time on low pri cleanup. Thanks scott!

[scottofletcher]

oh, ok no that makes sense, thank you. I think including quotation marks in the 'AND' example would clarify that - ie. AND: bicycle and rally (this is the default, so the same as "bicycle rally") will return items which match both words. or just leave out the part in brackets altogether and have AND: bicycle and rally will return items which match both words.

[scottofletcher]

@jesicarson @ascott couple minor edits to the above: (note: I'd put 'search bar' before 'search filters' since the latter mentions keyword search)

Homepage: By default, the homepage displays all of the entries on the website starting with a curated set of featured content. Explore the interactive map to find content by location, or use the search filters under the Cases tab to narrow results.

Search Bar: Use the search bar at the top of any page to conduct a site-wide search using one or more keywords. Once your search results are displayed, sort the results by content type such as cases, methods or organizations.

Search Filters: Search filters are available on the homepage under the Cases tab. These filters apply to all cases and can be used to further refine a keyword search.