ming-00 / ped Goto Github PK

There is no feature that can let users know efficiently and effectively which are the words they are weakest at. Quiz does not store that information at all, users have to manually remember, and even then they cannot simply quiz themselves on those words unless the user remembers all the weakest words, manually tags them one by one, and then deletes the tags later when they have mastered the words. Otherwise, if they want to be quizzed on their weakest words, they can only go to quiz mode as normal and hope that their weakest words appear.

I have to manually add tags 1 by 1 to each flashcard. eg. if i want to mark 30 cards with a tag, i have to go through them by index one by one and retype and assign the tags 30 times by keying in tag [INDEX] [the whole tag] 30 times.

Although the app checks if there are duplicate tags which were added manually, I can still add tags with the same name as the default tags to the flashcards. In the screenshot you can see that I was able to add the hiragana tag although the flashcard already has a hiragana tag.

Attempts should be listed in descending order of date. If a user uses this app multiple times, it will be very troublesome for them to scroll and see the results and statistics of their latest attempt which is what they would be most concerned about.

Users are only able to use the few flashcards provided in app. There is no feature to add new flashcards when users pick up new vocabulary, or delete flashcards that users have already mastered. The progress that users can make in this app is therefore quite limited. Although the user guide does say that these features might be available in v2.0, one would expect these features to be present in a flashcard app from the start. The app is also advertised such that users can "manage flashcards" as stated in the user guide, so it should be expected that basic functionalities such as at least adding or deleting should be available.

Error message does not correspond to answer provided.

Answers that users provide in quiz sessions should be case insensitive because it has no impact on the answer. Users can get annoyed if their answer is technically correct but not accepted.

I don't have a video but please take my word for it!

I think it makes sense for adding tags to have the command "tag" but the command for deleting tags is just "delete", which is misleading as it seems like a command for deleting flashcards.

After a quiz session, the app should display all the flashcards showed in the session because users would want to revise.
Right now, I think it is a feature flaw because:

• As covered in a previous issue, I want to check the flashcards that I could not get the answer to, which I cannot do so unless I go back to learn mode and manually search through 100+ cards
• I want to go through all the questions covered and see what I am weaker in

Currently, there's not a lot of value added to quiz sessions vs a user just toggling between learn and quiz mode and scrolling through the flashcards, which might even be faster, where at least I can find out the answer to a flashcard easily.

If I am unable to provide an answer for a flashcard, I will have to retry and retry until I get it myself, or just click next to go to the next question. However, the correct answer is not shown to me afterwards when the session ends either. So this means that I have to remember the flashcard I could not answer, and go to learn mode after the quiz session ends, and manually search through 100+ flashcards so that I can learn the answer.

When I'm not in a quiz session, the check command itself is invalid because it is unique to quiz sessions only. However the error message displayed is "invalid command format" when it should be "invalid command" and notify the user that the command itself cannot be used in other modes. The error message for other quiz only commands are okay (see screenshot for next). Here I am in history:

The user should ideally provide the list of flashcards and their answers so that users/ testers who do not know Japanese can also test the quiz session. I would imagine that these testers would not be able to get through a complete quiz session if they cannot read hiragana/ katakana.

App provides example that is itself invalid.

When I want to give an answer to a flashcard, I have to type check before my answer. This is very inefficient especially since flashcards are supposed to be conducive for quick and easy usage to test your concepts. As a user, I would also be expecting the default action when in a quiz session to be typing in my answer to a flashcard. It seems unintuitive to make the default action so inconvenient, especially since for many of the flashcards, typing "check" is already longer than the answer e.g. some answers are just "a", then I have to type "check a", spending more time typing out the command than the answer.

When user wants to start a quiz session, the command is as follows: start [n/NUMBER] [t/TAG]. i.e. it is optional to specify the number of questions that you want to be tested. However it is not clear what the default number is as it is not stated in the user guide, which would be a documentation flaw in that case. I tried running through the quiz and went though >40 flashcards, but still did not reach an end. I suspect it might be generating an infinite number of questions and will continue asking questions indefinitely, so I can only end the session by indicating end, which is equivalent to terminating "early". In that case, my attempt will not be recorded at all in history.

As seen here, my attempt is not recorded if I have to terminate "early" from not indicating a number.

When I just write tag [INDEX] without any tags at all, app will indicate tag added successfully.

To start a quiz session, I have to first toggle to quiz mode first by entering quiz, then starting the quiz by entering start. There seems to be an additional unnecessary step especially since quiz mode, which removes the answer from flashcards, does not even seem related to quiz sessions.

Users must always have entered quiz before entering start to start an actual quiz. Additionally, I can’t always tell immediately if I am in quiz mode (e.g. even after finishing a quiz and I want to continue with another quiz and I enter “Start”, the app tells me that I am not in quiz mode... but I just finished a quiz! I should be in quiz mode).

There is no way to see all the available tags. If I am in the app, I can’t always remember what tags there are when I want to enter quiz mode. This means I might have to scroll through all the flashcards to recall, which is quite troublesome, especially since tags are supposed to make things more convenient.

I can’t look for a specific flashcard that I want immediately as there is no command for me to do so/ filter flashcards by tag for learning and quiz mode, and there are too many flashcards to search efficiently manually. I also cannot enter learn/quiz mode for a particular tag if i want to revise for vocabulary that particular tag, which I think defeats the purpose of having a tag as the tag can only be used during the quiz session itself.

When I key in delete [INDEX that is out of bounds], the error message correctly gives "The flashcard index provided is invalid", but when I key in other invalid indexes like 0, the error message changes to a less accurate error message. Same for "tag".

Users have to scroll horizontally to read the notifications sometimes. While this can be mitigated by resizing the window, a user would expect that the default size in which the app opens up in should not have this issue and that the app design is suitable and most convenient for use at that size already.

Since the application has different modes, it would make more sense to group the commands only applicable to one mode together. The current implementation does not to so (end is more of a quiz session related command and should be grouped with the quiz mode commands). Although end has several different functions depending on the mode, it is most relevant to the quiz mode (and its instructions also are geared only to quiz sessions: "Ends the current session, saving progress."), so I take it as a quiz mode command.

As a language learner who has had experience learning Japanese and also tried many other language learning flashcard apps before, the question and answer format is not ideal for picking up languages as at best it can only encourage passive recall, and not active recall. This is genuinely an important issue for language learning flashcards.

In general, almost all (if not all) quiz apps should be giving you the question in your native language, which you then have the input the answer in the language that you are learning (i.e. Japanese) and not the other way round because you need to train your active recall.

This is also true if you think about flashcard apps in general: they give you the "definition" and you are supposed to give the "word" that corresponds to the definition. In this case the definition should be the english translation, and the word should be the japanese vocabulary.

This is understandable for the hiragana and katakana flashcards (because the phonetic sound as a prompt will always give away the alphabet when you’re typing with a keyboard), but for everything else (i.e. actual vocabulary flashcards) it would make more sense for the user to input the Japanese phrases instead of the other way round. I think it would be best if users can at least toggle between the two options for more flexibility.

Although this might make it harder for testers to test, this can be mitigated by providing the list of flashcards in user guide/ developer guide.