gtg icon indicating copy to clipboard operation
gtg copied to clipboard

Add search syntax cheatsheet help popup

Open diegogangl opened this issue 4 years ago • 7 comments

Quick idea I had, I can never quite remember this. The button in the search field toggles the popup with a quick cheatsheet of the syntax.

Screenshot from 2021-11-08 19-42-15

We could do the same with the quick add entry. Replacing the emojis button with one of this.

diegogangl avatar Nov 08 '21 22:11 diegogangl

Also, It seems a bit inconsistent for me with word but later [date] is being used later. And what the exact difference between word and "text" isn't very clear (maybe add spaces in the example?). Also, what about word word?

I copy/pasted from the table in help, but I agree we could make it clearer

diegogangl avatar Nov 09 '21 12:11 diegogangl

Updated

Screenshot from 2021-11-09 18-41-00

diegogangl avatar Nov 09 '21 21:11 diegogangl

Looks better now, but what about [word] [word]? I think that is useful to know

Neui avatar Nov 09 '21 22:11 Neui

My first reaction was, "Don't we have GtkTooltips for this?" but I understand that those are probably too limited in styling (especially text wrapping etc.) and that the popover approach is preferrable. Just gotta make sure it doesn't interfere with focus or keyboard use in general or something like that (I don't have specific in mind here, I don't know why I'm saying this vague theoretical concern, but I'm saying it just in case there is something we haven't thought of). I think the UI you are proposing looks pretty neat.

Is it supposed to support the tags:foo,bar,baz syntax too like the quickadd entry, or is that specific to the quickadd entry?

As for the quickadd entry, is there much more to document than what's already in the tooltip? If not, then it could probably remain simply as a one-line tooltip like it is now...

nekohayo avatar Nov 10 '21 19:11 nekohayo

Another theoretical concern (but probably not an actual issue): are the translated versions of the soon, now, etc. keywords accepted as input in the app in practice? I think so, but I don't remember if it worked 100%.

In any case, at first glance and very broadly looking (and without testing), it looks good. What could possibly go wrong? :)

nekohayo avatar Nov 10 '21 19:11 nekohayo

At the moment this is just for the search box and you manually need to click on the little icon in the search entry (not sure if it is keyboard friendly). And to my knowledge, the search box and quick add entries accept translated keywords.

Neui avatar Nov 10 '21 19:11 Neui

Oh right this is for the search box at the top, which doesn't even have a tooltip right now,
not the quick-add entry at the bottom!

Makes a lot of sense, now that I'm looking at this again, given how many search operators there are.

@diegogangl would need to rebase this to work with master though, so marking this as a draft until then.

nekohayo avatar Feb 27 '24 01:02 nekohayo