search

ankitects / anki-manual

Anki's manual
https://docs.ankiweb.net
496 stars 174 forks source link

Clarify the difference between resched:x and prop:resched=x #301

Open user1823 opened 1 week ago

user1823 commented 1 week ago

What's the difference between the following two? It would be nice to explain it clearly in the manual.

From https://changes.ankiweb.net/changes/2.1.40-49.html

Originally posted by @user1823 in https://github.com/ankitects/anki-manual/issues/266#issuecomment-2363593251

dae replied:

resched was originally added to distinguish it from regular study: https://github.com/ankitects/anki/pull/918. I don't remember the specifics, and could be wrong, but I think that resched:x was added to distinguish from rated:x.

But, I don't really understand what this means.

brishtibheja commented 1 week ago

I didn't too at that time. I searched for prop:rated and found this PR: https://github.com/ankitects/anki/pull/926

Let's say I want to search which cards I reviewed 20 days ago from today.

You would think, it would be as simple as rated:21 -rated:20, however that's not the case. It would be the case for queries like added, and edited, but not for rated.

rated:21 -rated:20 actually gives you the cards, which you studied 20 days ago, but will also exclude those, which you happened to study starting today till 19 days ago. So cards you reviewed that day, but haven't since.

This PR is trying to solve this, by introducing equivalent prop searches, which allow for more specificity when searching for past reviews. So searching for 20 days ago would be as simple as prop:rated=-20.

This seems like a really useful thing. I remember telling other users in forums to use something like rated:x -rated:x-n without realising this obvious pitfall (have personally used this before too). Seems we have a better alternative.

I think we still can't stop documenting rated: searches as they support searching for specific grades. If you want to do that with prop:rated you'll have to use rated: anyway. But I do see reason for why we would want to have prop:rated documented.

Now, as for resched: searches I don't think we need to document them as prop:resched>-x = resched:x. I did some tests with rated:/prop:rated searches and it works so probably this one too.