Thanks for the suggestions, Johan. I will change the text and we will definitely look into making the shortcuts more apparent.

Cheers,
Doru

On Mon, Dec 8, 2014 at 5:17 PM, Johan Fabry <jfabry@dcc.uchile.cl> wrote:

OK now I get it … thanks for clarifying!
I think my confusion stems from the use of ‘category' and then talking about 'the collection object’, which made me think about collections and source code and protocols and packages and I got lost.

I think that the sentence of the blog would be clearer like this (uppercase to show changes):

To do this, GTSpotter offers an extra action: diving in a RESULTS category. Pressing Cmd+Shift+ArrowRight dives in the collection OF RESULTS OF that category. Thus, we can continue refining the search inside the category.

So then, my suggestion for a legend at the bottom of the results list would be:
Cmd+Shift+ArrowUp/ArrowDown = Next/Prev category, Cmd+RightArrow = Dive into Result, Cmd+Shift+RightArrow = Dive into Category

> On Dec 8, 2014, at 12:48, Tudor Girba <tudor@tudorgirba.com> wrote:
>
> Hi,
>
> Ok. Let's take it step by step and see if we cannot find a better way of explaining.
>
> Take a look at the first picture in the blog post. Entering GTSpo shows results both for Classes and for Packages. These "Classes" and "Packages" are what we call search categories, and they have associated a query processor that can populate them with results (see the "Spotting your objects" section from the bottom of the post).
>
> In our case, we get 39 classes (of which only 5 are shown) and 1 package that match the query. If you want to look at all those 39 classes, you can dive in the whole collection behind the category in a separate step. This is achieved through Cmd+Shift+ArrowRight. Does it make more sense now?
>
> I did not consider the category to be confusing. Would you propose another name?
>
> Cheers,
> Doru
>
>
> On Mon, Dec 8, 2014 at 4:02 PM, Johan Fabry <jfabry@dcc.uchile.cl> wrote:
> Sorry, but no :-(
>
> I am always confused when people say ‘category’ because the word has so many overloaded meanings. The same happens in the blog post, it is not clear to me what category means here, and what does it have to do with the collection object?
>
> > On Dec 7, 2014, at 11:16, Tudor Girba <tudor@tudorgirba.com> wrote:
> >
> > Hi,
> >
> > Yes, we will still evolve the UI. At the very least you will get the shortkeys directly on the actions.
> >
> > The answer to your question is in the blog post:
> > GTSpotter offers an extra action: diving in a category. Pressing Cmd+Shift+ArrowRight dives in the collection object containing only the items from that category. Thus, we can continue refining the search inside the category.
> >
> > So, you will open the collection of that sub-category and you will see more items at once (not just 5). Is it clearer now?
> >
> > Cheers,
> > Doru
>
>
>
> ---> Save our in-boxes! http://emailcharter.org <---
>
> Johan Fabry   -   http://pleiad.cl/~jfabry
> PLEIAD lab  -  Computer Science Department (DCC)  -  University of Chile
>
>
>
>
> --
> www.tudorgirba.com
>
> "Every thing has its own flow"



---> Save our in-boxes! http://emailcharter.org <---

Johan Fabry   -   http://pleiad.cl/~jfabry
PLEIAD lab  -  Computer Science Department (DCC)  -  University of Chile




--
www.tudorgirba.com

"Every thing has its own flow"