I try to be brief, but it is not an easy topic.
I don’t aim to criticise anything, I am thankful for anki, it is a really valuable contribution to making the world better. I really appreciate it. And I personally start to like it.
My point is the manual. I Have difficulties with it, and want to suggest a kind of endeavour to improve it.
But I don’t know if this is appreciated at all.
I tried to start something on the anki reddit, but I just can’t post over there.
In my opinion the anki manual needs more care.
I experienced it being difficult to start with anki, it has a steep learning curve (imho).
Wouldn’t it help to make Anki more popular, by improving it’s documentation ?
I give examples.
Under “key concepts” you find “Types of Cards” and then later “Card Types” - both refering to completely different concepts. I think, for the former, “Card Status” might be more adequate.
I understand the buttons “Again”, “Hard”, “Good”, “Easy”. I also understand the numbers above: It is the consequence of pressing that button to the time when the card will be shown again, in accordance to the concept of spaced repetition, and it’s optimisation(s).
However, it is difficult to relate this to the deck-options.
For example, the explaination on “Learning steps” says "…The first delay will be used if you press the “Again” button, … The "Good " button will advance to the next step.
With “Step” is it meant “Advance to the next DELAY” ?
And, what if THEN, after advancement, “Again” is pressed ? Will it go back to the previous delay ?
and so son.
Sugestion: Wouldn’t it be useful to have a kind of flowchart to explain these mechanics ?
The structure of the manual is
(1) Quickstart -->going to “Getting Started”
(2) getting help
I think it should be more something like this:
Here, briefly mention the key concepts and what is anki all about.
Here, explain how anki is used, with the buttons, what the mean, how the behave mechanically,
how the time values are related to it,
explain the options more tidy, more convenient, in short, clear sentences.
Managing Learning Decks
Creating / Editing Cards
Creating / Editting Decks
** Example 4 **
In the categories if the Anki Forum, there is no place for “Documentation”,
and the existing categories “enforce” to relate questions or topics to a specific platform version, which is not adequate for general questions in the anki software itself.
So, I can’t even post this in the right place. I posted it to “anki desktop” in lack of a more suitable place.
I am willing to help making the manual better, if this is needed and wanted, but I need some
correspondance to work on anything.