Official announcement on upcoming API Version 2 breaking changes. Addition of new endpoint /spaced_repetition_systems

@viet this is feedback on the planned phase out of the SRS stage names. There is more to these names than a naming convention for the SRS stage numbers. Users are using them for these two purposes:

  • Tracking their progress
  • Managing their workload

Using are measuring their progress by watching the SRS stage their items have reached. The numbers in the dashboard colored boxes are a useful tool. They are also used in scripts. For example wkstats provides a table of items colored by the SRS stage they have reached. See under “Items”, “Wanikani” submenu option. Depending on how the report is configured we can see for each level which SRS stage the item has reached. Another script is Level by SRS which identifies the highest level where 90% of the items has reached a SRS stage. If names are removed then the question arises of how users will track their progress and how script will be developed for this purpose. Multiple SRS systems without a naming convention will make things more difficult to track and understand. Whatever you do, please plan some way to make progress tracking easy and understandable.

The other big use is workload management. Users have observed that the bulk of their reviews are apprentice items. Many users got in the habit of setting a maximum to the number of apprentice. When this limit is exceeded they stop doing lessons until the apprentice count decreases below the limit. This keeps their review workload within bounds they are comfortable with. Some users impose a similar limit to guru items as well. If the SRS names are removed and multiple SRS systems are implemented the question arises of how these users will control their workload. Whatever you do, please provide a way for users to similarly control their workload in the new system.

This feedback is not meant to hinder the planned changes. The goal is to make sure you are aware of the implications to the users in the hope that they will be taken care of.

17 Likes