It's been a hot minute since the last update, but that just means this one is all the more overdue and full of goodness! So, we're back with an update that everyone has been wanting: Review Sets.
One of the questions that we get quite a bit in our community is "How do I review more?" or "I am struggling with this flashcard, can I add it to a custom flashcard deck so that I can review it more?" We wanted to make sure we answered this question in a way that aligns with NativShark's core principles while also giving our students ways to do things in a manner that suits them.
In short-- Review Sets are a way for you to quickly review groups of content as much as you want, without affecting SRS intervals or the progression system that runs in the background. Even more than that, they are the first step towards students being able to essentially create their own study content within NativShark, to enhance their core study experience in a unique way. We've even added the ability to share the review content that you create with fellow students via a link. More on that later though.
Since review sets are quite a significant feature, we've put together the video below as a quick walkthrough.
Review sets have a logical structure that mimics the structure we use in NativShark Core. Let's walk through some terminology so that we're all on the same page!
When you study a review set, you are presented with the content in the same order that you encounter them when learning a new unit in NativShark-- materials followed by cards. Before we talk about the process of reviewing a review set, let's take a look at how you create them and add materials/cards to them.
You will notice a new backpack icon in various places around NativShark. This backpack represents your review sets and is what you will use to fill them with various content. We chose a backpack because we want you to think of review sets as a place where you tuck away anything you want to take an extra close look at later, or practice on your own, outside of the Core curriculum. Just like a backpack you'll be able to store and retrieve any content you place in there for later. This backpack is with you at all times and will get smarter over time to provide even more benefits.
Let's take a look at some of the different places that you'll see the backpack on the site now:
As part of the NativShark philosophy, we wanted to make it simple to add content to your review sets from anywhere as well as create new review sets if needed.
The image above shows what happens if you click on the backpack icon for a vocabulary card. On the left you will see a preview of the card (vocabulary, lesson, custom, or kanji) and on the right side you see a list of your review sets. From here you can create a new review set, add it to any review sets that you have created, as well as remove it from any review sets it is already a part of. This flow makes it so that you do not have to go anywhere else to make a review set and add content to it – you can do it all from the content itself.
This extends beyond simply adding the materials to a review set, though. As we mentioned above, review sets can contain any number of units. What if you want to add a material to a specific unit within a review set? We've thought of that as well ✨
When you click on the arrow to the right of any of the review sets, you are shown the units that are in that review set. Here you can quickly filter the units by their name to get to the one you want as well as add a new unit. If you add a new unit, a new unit is created and the material is added to that unit immediately.
When you need more fine-tuned control over your review sets, you have access to that as well. You'll notice a new menu entry available under the "Library" menu titled "Review Sets". This is your home for your review sets and where you will go to review them, create any new ones or manage what you have created in the past.
Before we talk about the "Study" tab, allow us to explore the "Create" tab. When you click on "Create", you are presented with two separate tables. One shows you any review sets that you are creating and the other one shows you any review sets that you have published. We will talk more about the publishing/sharing flow for review sets later.
When you are looking at a review set draft, you will see a few more options when it comes to organizing the content within the review set. You can drag and drop units, materials and cards to re-order them or move them to a separate unit. You can also give names to your units, allowing you to logically group them as you see fit.
While review sets were designed so that you could tailor them to your own needs, we also understand that it can be useful to either share what you've made or use something someone else has put together. While we don't currently have support for publicly-searchable review sets, we do allow people to share review sets they've created with others via a link.
All review sets are published as "Private" by default, though this status can be changed at any time. By switching the status to "Link Only", you can send the URL of that page to anyone and they will be able to start studying that review set, including any custom flashcards that you have added to it! We want to mention that you can change this setting at any time. If you change your review set from "Link Only" to "Private", anyone who was studying the review set loses access to it and are notified that the sharing status of the review set has changed.
Those of you who are more eagle-eyed may have noticed the "Make Copy" button. We wanted to make it so that review sets can be copied and updated by anyone so that they can make things their way. Perhaps someone likes a review set the way it is and doesn't want updates to it, or maybe they like the review set but want to remove some lessons that they don't need to review. By making a copy, they create a draft containing everything from the original review set except custom flashcards. When custom flashcards are created in NativShark, they are 'owned' by the account that created them, and that creator is responsible for their content. Since you do not own another accounts' custom flashcards, they are not included in the copy you made.
After creating a review set and publishing it, it's likely that you'll want to make changes to it. In order to preserve the user experience for all who are reviewing that set, we wanted to make sure any changes that are made are contained to a single update. The way we went about this was by creating a "draft" system.
Once a review set is published, it can no-longer be edited, however this does not mean that it can't be changed. To update a review set that has been published, first you create a draft of that review set, edit the draft, and then publish that draft. Anyone reviewing or looking at the review set will receive a notice that a new version has been published and prompt them to either restart their session with the new version or to refresh the page.
Another benefit of the draft system is that you are free to experiment and make changes without committing to them. If you decide that you don't like the changes you've made, you can simply delete the draft. The published review set remains untouched by this action.
One last note we want to make when it comes to managing your review sets involves deleting review sets. You can delete a draft at any time, but once a review set is published, you must first unpublish the review set before deleting it. This ensures that you are fully aware of what you are doing and do not accidentally delete a published review set, as this action cannot be reversed.
When you look at a published review set, you will see a "Start Studying" button. By clicking this, you add the review set to your collection of review sets that you are studying. Once you click on it, the interface changes a little bit to reflect the new state that the review set is in:
There's a handful of options in here that are mostly self-explanatory, but let's go over them real quick before diving into the most important option ("Start Set"):
Let's jump into the "Start Set" button now and what the review set flow actually looks like.
Once you've configured the units that you wish to review, you are then placed into your reviews. The process of studying a review set is much like working through a unit in NativShark. You will notice a "Mark as Reviewed" button in lessons and dialogues and by clicking on that you move onto the next item in the review set. Let's look at what working through the above review set looks like now:
The first thing that the review set had in it was a lesson, and so we are presented with the lesson. Notice the banner at the top of the screen that lets you know which review set and which unit you are in. This banner stays pinned at the top of the page as you scroll down so that you never lose track of where you are. At the bottom of the lesson, you are presented with a familiar footer that allows you to update your comprehension rating (if you are looking at a lesson you've completed in your core studies) and move onto the next part of the review set.
When we finish this lesson, we are then shown the flashcards that are in this unit. You'll notice in the image below that this part looks similar to when you are learning new kanji and vocabulary in NativShark, but it behaves in a very deliberate way.
The way flashcards work in a review set is as follows:
Reading the bullet points above may be slightly confusing, here's is a video that shows this process from start to finish:
After the flashcards, we are then presented with the dialogue that was in unit 2, followed by the flashcards that were in unit 2 (as we would expect).
Once you work through the review set, you are returned to your Review Sets overview page.
When you go to the Review Sets page, you are presented with two tables: one showing your active review sets and another showing your archived review sets.
These tables are fairly straight-forward, though we wanted to call attention to a couple of areas. If you have previously started studying a review set and did not finish it, the review set will remember what your next task was and will show you what you are going to do if you click "Review". It also keeps track of how many times you've done a review set as well. You can archive any active review sets by selecting their checkbox and clicking the "Archive selected" button that appears.
When a review set is archived, you are able to unarchive it or remove it from your studies entirely. To unarchive it, you can either click on the button in the table or click the checkbox for the review sets that you wish to unarchive via the "Unarchive selected" button that appears. To remove it from your studies, you click on the checkbox and then click the "Remove selected from studies" button that appears.
With review sets, we are testing a few different things under the hood. This means that you may notice things render slightly differently during your reviews and that some behavior has been enhanced (such as hovering over words in the flashcard sentences to highlight the corresponding literal). These are tests that we are running to see if our new approach to rendering things gives us the flexibility we need before we port it back to the other parts of the system. A hidden feature of this new renderer is that you can now copy and paste the Japanese as you would expect!
Let us know what you think about this new renderer in our Discord community! We're pretty excited about it and looking forward to updating our older code to be able to take advantage of it.
While review sets are the main point of this update, there are some other things that we changed as well which we want to talk about below. Read on for some little gems that we are sneaking into this update~
This update has been a long time coming, but we are glad to finally have it ready for release. We are constantly working to improve our data models behind the scenes to enable more rapid development of features and content, stay tuned for more info on that in some future update post! For now, know that we are always listening to your feedback and suggestions and are working to make the platform work for you!
Well, that's all for now :) we hope to see you in our Discord community making friends, giving us your honest opinions, and creating an enjoyable place where everyone can learn and improve their abilities together.