<div dir="ltr">So, replying to basically everything here and no one in particular.<div><br></div><div>1. User expectation (based upon years of Google) is that search 'just works'. One box, I type in what i want, and I get it. No need to specify fields, etc.</div><div>2. The ability to search particular fields is a nice-to-have for advanced users, but generally goes unused even when available. (Happy to grab a drink and talk at length on why I know this kind of stuff...long story...)</div><div>3. Let's not confuse Search with Filtering nor Querying.</div><div>   3a. Search is when you type what you want into a search box and you get it.</div><div>   3b. Filtering is when I'm looking at stuff and I want to see less of it. Generally interactive.</div><div>   3c. Querying is essentially a+b, and normally queries can be saved for repeat usage. Filtering post-query is also common. In general, queries are used to populate a UI. For example, a Kanban board, a Product backlog, a Sprint Backlog, a list of release blockers, etc. etc. These UIs are generally driven by a query, and users should be able to have multiple queries driving them.</div><div><br></div><div>What's more important to consider are the 'magic' variables that need to be part of queries. Things like '@me' -- so, a query for "assignedTo=@me" would return all items that are assigned to 'me', regardless of who runs the query. @project, @organization, etc. Probably some form of current date/time (@now, @month). Less easy to do are things like @currentIteration, because there can be multiple, overlapping iterations, but we should think about them.</div></div><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Oct 20, 2016 at 8:53 AM, Monica Granfield <span dir="ltr"><<a href="mailto:mgranfie@redhat.com" target="_blank">mgranfie@redhat.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote"><span class="">On Thu, Oct 20, 2016 at 3:23 AM, Shoubhik Bose <span dir="ltr"><<a href="mailto:shbose@redhat.com" target="_blank">shbose@redhat.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div><div><div>Hi folks,<br></div><br>Wanted to discuss how the /api/search URL(s) would look like.<br><br></div>To set the scope of the discussion right, I must mention that in this sprint we are working on supporting search on ID , URL and full text ( for title and description only ) of a workitem.<br></div></div></blockquote><div><br></div></span><div>** Am curious what is driving the need for these attributes to search by? I would have thought that search by assigned to would be a top candidate as these three attributes all focus on the work item only. Can we replace string with Assignee, as to address this issue? </div><span class=""><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div><br><br></div><div><ol><li>The ID search is currently only on workitems. ( But in future it would be supported for other objects as well. Example, Users,etc. )<br><br>To search by ID --<br><br>/api/search/q<b>=id:4324</b>  <br>This is going to look up the workitem table <b>only</b>. <br><br><br></li><li><br>To search by URL --<br><br>/api/search/q<b>=url:<a href="http://demo.almighty.io/#/detail/71" target="_blank">http://demo.<wbr>almighty.io/#/detail/71</a></b>  <br><br><br><br></li><li><br>Search by ID *AND* URL is not supported.<br>If a q=xxyzz  contains both URL and ID, we only pickup the URL and discard the rest.<br><br>Example.<br>/api/search/q=<b>id:4324</b>+<b>url:<a href="http://demo.almighty.io/#/detail/71" target="_blank">http<wbr>://demo.almighty.io/#/detail/7<wbr>1</a><br><br></b>is effectively<br><br><b> </b>/api/search/q=<b>url:<a href="http://demo.almighty.io/#/detail/71" target="_blank">http://demo.<wbr>almighty.io/#/detail/71</a></b></li></ol></div></div></blockquote><div><br></div></span><div>Behaviorally if I typed in 731 http://..../......</div><div><br></div><div>I would expect it to pick up the ID first, as it is first in order. I am also wondering about the fuzzy type ahead that Max mentioned and if any thought has been given around that?</div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class=""><div dir="ltr"><div><ol><li><b><br><br><br></b></li><li><br>Free text search is supported only on workitem title and description<br><br>/api/search/q:=<b>title:some title substring</b>+<b>description:some description substring<br></b><br><b><br></b></li><li><br>The delimiter for multiple clauses ( we shall support "AND" now ) will be "+" . ( inspired from Github ) as already used above. We need to consider situations where the string itself contains a "+" by escaping them properly.<br><br><br></li><li>if the search query contains a mix of ID, URL , title,description :<br>The order in which we are going to look for fields to make a decision on the search is:<br><br>1. URL<br>2. ID <br>3. title and description ( for free text search )<br><br><br><br><br>Let me know your thoughts :)<br><br><br>-<br>Shoubhik<br><br><br></li></ol></div></div>
<br></span><span class="">______________________________<wbr>_________________<br>
almighty-public mailing list<br>
<a href="mailto:almighty-public@redhat.com" target="_blank">almighty-public@redhat.com</a><br>
<a href="https://www.redhat.com/mailman/listinfo/almighty-public" rel="noreferrer" target="_blank">https://www.redhat.com/mailman<wbr>/listinfo/almighty-public</a><br>
<br></span></blockquote></div><br></div></div>
<br>______________________________<wbr>_________________<br>
almighty-public mailing list<br>
<a href="mailto:almighty-public@redhat.com">almighty-public@redhat.com</a><br>
<a href="https://www.redhat.com/mailman/listinfo/almighty-public" rel="noreferrer" target="_blank">https://www.redhat.com/<wbr>mailman/listinfo/almighty-<wbr>public</a><br>
<br></blockquote></div><br></div>