There are 2 big problems:
1. If you are studying seriously, you will encounter many words outside your SRS practice, so the FSRS prediction fails flat.
2. More importantly, language learning is not about recalling words.
The algorithm I use for my app has a different set of objectives, it's <30 lines of straightforward code, and it works better (I tested it for months to be sure about it)
I'll open source it soon
I had some problems with their documentation though. Following their examples was pretty straightforward, but I always had trouble e.g. what is the difference between State.Learning and State.Relearning, or what does fuzzy mean in FSRS parameters, or reps on a Card. You have to either read the algorithm explainer or the Anki source code to understand that.
I complain here, but this is open source and if I was slightly more ambitious I would submit PR with the missing docs (or at least an issue).
PS. my work is here https://github.com/runarberg/shodoku in case you are interested, but the source code bears the mark of being a weekend hobby project, so read at own risk ;)
I'd like to port my own flashcards app, Manabi from SM2 to FSRS so this is helpful
I made this companion reader app as well, btw, for learning Japanese: https://reader.manabi.io
This library also makes it easy to undo a review (one of my missing features) as long as you keep the review records (which this library also makes easy).
> If you insist on paying for this app, consider donating to UNWRA instead.
Glad to see solidarity among the Japanese learning community.
It is great to have the docs well organized like this, what is missing is just a short explanation of what all those mean. The information is available, e.g. in the README or in the source code. So honestly it is just a minor annoyance, rather than a major issue. I was able to use ts-fsrs just fine actually.
The Anki database format is still pretty opaque, despite a few efforts over the years, and it would be great to open some of this this up to allow apps to export apkgs
It doesn't help that our wiki is noindexed by GitHub: https://github.com/ankidroid/Anki-Android/wiki/Database-Stru...
I agree that our documentation is pretty bad at the moment haha. But I'm hoping we'll start cleaning things up more this year. I'd also like to potentially move away from using github's wiki system...