ankitects / anki-manual

Anki's manual
https://docs.ankiweb.net
495 stars 173 forks source link

Added recommendations on how to use the answer buttons #269

Closed Expertium closed 1 month ago

Expertium commented 1 month ago

Closes https://github.com/ankitects/anki-manual/issues/260

brishtibheja commented 1 month ago

I was wanting to do this eventually, but in a different way:

  1. Remove the topics about how grades are chosen.
  2. Retain these paragraphs somewhere:

    See Deck Options and the FAQ to learn more about how the algorithm works. You can use the 1, 2, 3 and 4 keys on your keyboard to select a particular button, where 1 is Again. Pressing Space or Enter will select Good.

  3. Name the current topic "Grading cards".
Expertium commented 1 month ago

Retain these paragraphs somewhere

The problem is - where?

dae commented 1 month ago

I'm reasonably happy with what these changes are trying to convey, but feel the wording could still be better. For example, how about changing the start of the section to remove the current intro, and using something like:

Hard and Easy marks your answer as correct, and tells Anki to be more or less aggressive when scheduling that card in the future. This can result in more efficient scheduling for cards that are uncommonly hard or easy, but some users feel that the extra time taken to decide on an answer button is not worth it. If you decide to use these buttons, you should expect to be using them about 5-10% of the time. If you find yourself marking the majority of your cards as Hard, you should probably be using the Good button instead.

Expertium commented 1 month ago

1) Ok, no intro. 2) I disagree about percentages, since they imply a fixed retention rate. Let's not use percentages. 3) No "tells Anki to be more or less aggressive when scheduling" or "more efficient scheduling". Dae, please understand, this has to be as beginner-friendly as possible. Imagine that you are trying to explain this stuff to your grandma.

dae commented 1 month ago

The reason why I think we might want percentages is they give users a ballpark figure for what's reasonable - if they find themselves using Hard 50% of the time, that's clearly a lot different to 5%. I'm aware there'll be some individual variation, but still feel that 'about 90%' and 'about 5%' might be more useful than providing no guidance whatsoever.

Dae, please understand, this has to be as beginner-friendly as possible. Imagine that you are trying to explain this stuff to your grandma.

The tone I was going for was 'you don't need to use these buttons, but if you wish to, here's what they do'. I don't think you can avoid talking about what they do completely, but perhaps this could be reworded so such users don't feel the need to read further.

Expertium commented 1 month ago

Alright, how about this?


Simply put, press Again if your answer is completely incorrect, and press Hard, Good, or Easy if your answer is correct. If you don't feel confident in your ability to decide precisely how difficult a card is, you can only use Again and Good, which is a perfectly valid way of using Anki.

dae commented 1 month ago

I'm ok with that wording. I personally think listing hard/easy further below and/or mentioning 2 buttons are valid further above might also be worth doing, but it's not a blocker.

dae commented 1 month ago

Simply put, press Again if your answer is completely incorrect, and press Hard, Good, or Easy if your answer is correct.

This still leaves open questions about 'how incorrect is incorrect', and might risk encouraging users to use hard on partially-forgotten material.

Expertium commented 1 month ago

Listing Hard and Easy separately would be weird.

This still leaves open questions about 'how incorrect is incorrect'

I'd love to write an entire paragraph about 'how incorrect is incorrect', but the whole purpose of this section is to be clear and easy to understand. What wording would you use?

dae commented 1 month ago

Perhaps it would be better not to talk about minor/non-critical mistakes? E.g.


Hard should be pressed if your answer is correct, but you had doubts about it or if you made a minor, non-critical mistake.

Hard should be pressed if your answer is correct, but took a long time to recall.

Simply put, press Again if your answer is completely incorrect, and press Hard, Good, or Easy if your answer is correct.

Simply put, press Again if your answer was not completely correct, and press Hard, Good, or Easy otherwise.


I think if we mention them, it might encourage the use of Hard when material has not been properly recalled.

dae commented 1 month ago

Thank you!

brishtibheja commented 1 month ago

Any issues with removing algorithmic information from here and link people to here and here instead ?

Explaining this doesn't make sense if people don't read deck options section.