How a Jalup Deck is Made – Behind the Scenes
Flash cards get a bad rap sometimes. Put a word or sentence on the front, the meaning on the back, and you’re done. Repeat this a few hundred or thousand times and you have a deck. Such a simple and bare tool. They’re just flash cards, right? Really…?
I thought it was about time I showed behind the scenes what goes into Jalup flash cards, and how they are far from just “flash cards.” You might even get your own ideas how to build decks in Japanese or another language.
Step 1: Research
Depending on the level of Japanese, the research requirements have varied greatly. Over time, there have been three main types of “Jalup research.”
Low Level: Jalup Beginner
Starting from scratch, I thought it would be easy to figure out the necessary basics to teach Japanese. But the order of how you introduce things is a complex subject. The good news is that there is a fairly similar approach among most textbooks, because it is logical. So I pored over a dozen textbooks (including a few English ones), to look for patterns. I agreed with some parts, others not so much, and put together an approach I was satisfied with.
Flash cards are good for small bits of information – textbooks love the opposite. This wasn’t going to work, so I had to get the essence of grammar down to the minimal clear wording (which took many tries to accomplish).
Since there is so much “beginner vocabulary” in most textbooks, I had to decide what was urgent and what was not. I wanted all of Jalup Beginner to fall within 1,000 cards. That meant I had to cut certain things. I could either teach all the numbers, days, months, colors, etc. at once or I could spread it out over time. I chose the latter because once you get one piece of a set of something, it is easier to teach the rest of the set later.
Medium Levels: Jalup Intermediate to Jalup Hero
Jalup Beginner was originally designed with the idea in mind that it would set you up to create your own J-J cards immediately after finishing. But when people were constantly telling me the trouble and failures they were having with J-J, I tried to find out if it was possible to do anything about this.
With my own studying years prior, I had amassed extensive experience creating my own Japanese only cards. Unfortunately, it didn’t help much, because creating J-J cards for someone else was an entirely different beast. I still didn’t even know at the time if it was possible. My own J-J cards relied heavily on my self-knowledge. I knew what I did and didn’t know. But to create a deck, I would have to expand the limited “knowledge pool” from Jalup Beginner without any outside assistance.
I had no idea where to start so I just dove right in with endless trial and error. It wasn’t as simple as just picking up a book and then adding Japanese words and definitions. Sentences needed to contain easy words and explanations. The two don’t necessarily go together. Cat is an easy word. Explaining it isn’t.
High Levels: Jalup Master, Jalup Champion, and Beyond
I made the decision to target specific books (manga) from this stage forward. I wanted to give people more confidence on specific media they could enjoy as well as provide level appropriate, fun recommendations for them.
I ended up reading the first several pages of dozens of manga to make sure that the level was about right, the language was actually frequently used, and whether it would be possible to follow from the current level of deck.
Decks up to this point allowed me to choose and skip whatever I wanted. I could save the trickier stuff for later. From here on out I had to include nearly everything.
Step 2. Find a word to introduce
Since every word relies on your previous knowledge, Jalup Beginner should have been the easiest. You knew zero words and I had the entire language at my disposal. But from the start I had to find just the right word at just the right difficulty, with just the right importance. Long term planning for flash cards was a priority. It is really more like a textbook split into linked pieces rather than just 1,000 separate pieces of info called a deck.
You’d think that the more cards and words that are made, the easier it would be to find new words. While I’d like to be able to say I’ve memorized all the words used in all of the Jalup decks, I haven’t. Which means whenever I go searching for a new word to introduce, I first have to search to see if I’ve already done it before. The further along I am in the decks, the more likely I can’t use a word I think is new.
What makes things worse is that I’m not just checking whether I can or can’t use a new word to introduce. I’m also checking all the words in the rest of the sentence, the definition and the note. In other words, i have to remember both what you do and don’t know, at every single step.
Step 3: Create an original sentence
Let’s say I wanted to introduce the word “red.” Simple. “This is a red pen.” Done?
While I’m not saying all the sentences in Jalup are interesting (plenty early on are run of the mill), I spent a lot of time making sure the sentences were memorable. Silly, stupid, weird, and emotional. Something that actually brings the sentence to life. A living sentence is one that you’ll remember. If a flash card has ever made you smile (or cringe), that wasn’t just luck.
A flash card isn’t just a boring piece of knowledge. It’s a story, wrapped up in one sentence. And in case you haven’t noticed, sometimes I tie more than one card together. You’ll see repeating characters and themes throughout the decks.
Step 4: Create an original definition
A good definition needs a perfect balance of information and ease. You should be able to look at it and think “okay, I get it.” And that’s just for Jalup Beginner.
Creating a Japanese-only definition from limited words is several times harder than creating the sentence on the front of a card. All current native Japanese dictionaries use too many words you don’t know (they expect you to be native after all) and often circle around back to the same synonym, resulting in a vicious cycle of confusion.
At first I tried just replacing unknown words with known ones. That didn’t work (until much later). I soon realized that I was going to have to create definitions from scratch. One positive side effect is that it made the definitions themselves more interesting, because sometimes a little mini story was required to get to the meaning.
Step 5: Add a note
Sometimes a definition isn’t enough and a bonus explanation is needed. Maybe an additional sample sentence. Maybe how the word is compared to another similar or different word. Maybe a point how the word may be used in different situations in the future.
Or maybe some oversight I realized later on, and this was the only place I could put an important piece of info without changing the order of all the cards…
Step 6: Edit. Edit. EDIT!
While it feels great to finish 1,000 cards, this leaves me far from finished. That moment was just a small victory before having to go back and fix the countless typos and errors. Card by card, I check:
- Spelling, grammar, spacing and other aesthetic issues.
- Comprehension (does this make sense and convey exactly what I’m trying to say?)
- Note necessity – does this card need a little extra boost?
- If I’ve used any words outside of what I was limited to.
Step 7: Edit – Native Style
The next round of edits come from a native Japanese speaker. For years now, my wife Yuki has been doing them (in the past I’ve also gotten help from others).
Card by card, everything is read in depth to make sure it all sounds natural. This was much harder in the beginning (especially Jalup Beginner) because I would get a healthy dose of “it would sound better if you change it to this.” The “this” would always involve some word that wasn’t introduced yet.
The limited vocabulary set was a challenge for Yuki as well (especially for J-J definitions). Natural Japanese without the usual freedom of choice requires a lot more work.
Step 8: Add in the furigana
Furigana, or the Japanese pronunciation guide that appears above kanji, is absolutely vital to every card, yet is so prone to mistakes.
I started off with an automatic generator, which uses a collective database to set up all the furigana readings. Thankfully this gets around 85% accuracy. Which is good… but also completely unacceptable. So I need to go through and fix all the problematic readings.
After I do this, Yuki briefly checks to make sure I didn’t miss anything.
Step 9: Package the deck
Once the deck is “complete,” I have to put it together for sale, set it up with the server, write up a long introduction post and actually get it out there so people can use it.
Step 10: Organize user-discovered card mistakes
Thought all that double editing caught everything? I wish. 1,000 flash cards is the equivalent of 2 full textbooks. There’s so much that can go wrong. Luckily, people on Jalup are kind, so when they discover errors, they not only point them out, they understand the inevitability of them.
This takes place over several months, as it requires many motivated users who not only finish the decks, but also want to help. I keep a running list of errors and once it gets big enough I add them all in at once. It would be impossible to update after every individual error as the update process takes time.
Step 11: Answer user questions
Despite my best attempts to be as clear as possible, I expect e-mail questions over the coming months about certain cards or issues a user is having while learning. I keep notes of issue patterns, and use this when I come around for later edits.
Step 12: Add audio
The original audio of Jalup Beginner several years ago was pretty bad. It was done using an internal laptop microphone, without much thought or editing. I later realized that good audio can make or break a learning resource and is just as important as all the other information provided on a card.
It needs to be clearly read, in a way that includes emotion (and isn’t just a boring textbook read sentence). Just like the sentences themselves, they need an infusion of “life” to make them feel more real. To record audio you enjoy and want to hear, Yuki:
- Uses professional equipment in a quiet home studio.
- Performs a lengthy voice check and warm-up (for every short recording session).
- Reads one sentence to herself a few times, figuring out how she wants to say it, and the way to make it sound best.
- Records one sentence several times.
- Listens back and chooses the recording she liked best. Occasionally she likes none of them and will record the same sentence again.
- Repeats the above 1,000 times.
- Discovers new deck errors which get added to the revision list.
- Realizes some sentences weren’t as natural as she originally thought and it was only reading them out loud that showed her that.
- Organizes all the files making sound edits for optimal quality.
I then listen to all 1,000 audio files, comparing them against the the cards. I keep a running tab of any cards that sound off, have background noise, or are wrong. Yuki re-records these cards. I check the re-recorded cards.
Step 13: Organize user-discovered audio mistakes
A repeat of Step 10, except with audio. Audio mistakes will be discovered and are listed and added to a later big update.
Step 14: Card linking
The least enjoyable part of the process, that takes forever and gives me countless headaches.
In order to get the card linking effect of the Jalup App, I have a large spreadsheet of all the sentences that I code manually, word by word. Every single card gets assigned a keyword, and then for every sentence/definition/note, keywords are added to all parts of a card. This means for one J-J Card, there are usually at least 25 keywords added. Times this by 1,000 cards and that is 25,000 manual keywords coded for one deck level.
I’ve gotten this a lot – “why don’t you just automate the process?” It’s been tried by myself and 2 other programmers (with way more experience than myself), and it just didn’t work.
Once I finish the spreadsheet juggernaut, I have to program the decks into both iOS and Android apps (which are built in separate languages) to allow for the app to handle the new deck in every function that uses it. Endless testing ensues.
I run an automated error check on the code linking spreadsheet I made. It’s highly character sensitive (intentionally), so one wrong parentheses or dash will cause an error to come up. I use all of these errors (usually several hundred) and go back and fix the spreadsheet accordingly. Yuki does a final check of the app, going through all the links. She attempts to tap every one of those 25,000 links…
The card linking process also points out ways I can update the older decks to make them better. Jalup Beginner and Intermediate were significantly improved when linked and uploaded to the app. Many notes were added, words changed, and clarifications were made. Advanced and Expert was also changed (though in more minor ways). For the people that complain Jalup Intermediate is too hard, you should have seen it before the updates, and especially before the card linking.
Step 15: Organize user-discovered card linking mistakes
Notice a pattern here? As with cards and audio, I get mistake reports over the coming months, and keep an ongoing list to update later. For each level, there are over 25,000 places I could have made a linking error. I do my best to keep this as low as possible.
Step 16: Repeat!
Everything I do here for a deck of 1,000 cards is repeated for each new deck. This is why the series has been in continual development for 5 years already and is still far from being finished.
And so the decks continue…
If you made it this far, thanks for reading till the end! I hope it shows that on Jalup, a flash card is not just a flash card. That I take things very seriously and pour an unimaginable amount of blood, sweat and tears into what I do here. That maybe this is a tool worthy of your Japanese journey.
Or not. They aren’t for everybody, and that’s completely fine. But for those that do use the decks, I hope you enjoy them. It’s an insane amount of work but luckily I love doing it and seeing the positive effect it has on people.
Founder of Jalup. iOS Software Engineer. Former attorney, translator, and interpreter. Still watching 月曜から夜ふかし weekly since 2013.
The amount of blood, sweat and tears poured into every single i flash card really shows!
Learning with the Jalup decks makes the journey many times easier. That’s how I feel at least.
Thanks for showing a bit of what happens behind the scenes. And thank you for your endless hard work.
That makes me very happy to hear. Thanks!
Very interesting. What are some examples of the notes that you add to cards later when you decide they need more…?
Two random examples of notes added later:
Note: Adding a で before ある to get である can either 1. end a sentence similar to です or 2. word1 である word2 = word2 that is word1
Note 1: The casual form of a verb is used before と思います。｜Note 2: と is used to connect the “think” verb to the phrase before it.｜Note 3: Similarly, と is used with other verbs to show that you’re “doing the verb” to everything preceding と, you do the verb with the result being what precedes と, or you do the verb in the manner preceding と.
“That I take things very seriously and pour an unimaginable amount of blood, sweat and tears into what I do here. That maybe this is a tool worthy of your Japanese journey.”
Indeed, it is helping a lot! Knowing how something is made, and how much the whole process requires, makes one appreciate it even more, and keep trying one´s best to make the most out of it.
The Japanese journey continues, and the product you offer is a great company and guide for that journey.
great post by the way.
If it can make your journey better, that makes it all worthwhile.
amazing effort from both of you! bought the maximum ANKI package a while back but wanted to buy the App for more features. Unfortunately seems paying in-app via paypal/mobile billing or credit card doesn’t seem to work yet for Android in my country!
Yeah this is an issue for some people who try to purchase it on Google Play. I e-mailed you about it.
Adam, the more I use your decks, the more I appreciate that I have access to them. The quality, convenience and other features, especially if used through the app, are completely unique and worth the price you’re asking. I shook my head when at some point I read on the internet that jalup was being unfavorably compared to free anki decks and even what a normal learner can create on anki on their own. One can have an opinion and preference on what is a useful/worthy tool/method for studying japanese, but the actual work that went into your products is undeniable. Great to know about all of this in detail through this article. Keep up the good work!
To anyone reading this who is on the fence about getting Jalup, I guarantee you there is currently no other product of this quality out there. If you are serious about learning Japanese but have time constraints or simply want the most convenient path to a high level, this is worth your money.
Some people on language learner forums complain about everything, and it’s the complainers who are the loudest. There are also some people that have held a weird grudge against Jalup ever since I started making and selling products to help people.
I don’t do Jalup for them. I do it for people like you who actually want to spend their time achieving their dream of learning Japanese.
Whether Jalup is worth the cost will always be subjective to opinion. It depends on how you value your own time and discipline.
If you have all the time and willpower in the world then no Jalup is probably not for you. Making you own Anki decks and spending time with the search feature instead of simply clicking a link would be no problem in that case.
For someone like me who have a ton of things in life I want to spend my time on Jalup is perfect. It means I get to spend my time with Japanese very efficiently.
I’d say Jalup if for anyone who has an interest in what it offers. Personally, I have a lot of time to study Japanese but I choose to use Jalup because of the efficiency and time and effort saved which I can put into other things. In terms of the quality and sheer amount of work involved, Jalup is definitely worth the price. In my opinion, of course.
The only time I’d advise against purchasing Jalup is if the learner wants to create a personalized deck for various reasons (some of which I have heard about and are truly valid like more retention and personal involvement), in which case the person would probably not be thinking of buying this to begin with.
I agree and always encourage people to study however they want. Using the Jalup decks isn’t a requirement to learn Japanese here. Which is why there are hundreds of articles that help people who would rather do everything themselves and “go solo.”
The card linking system was a game-changer. It helped SO MUCH during the j-j transition
Hearing that is the only thing that makes the link coding bearable :)
I can say that, now that I’m making my own cards, I have even more respect for the amount of work you’ve done. Finding example sentences can be so painful – I get really sad when goo doesn’t have one next to the definition – and getting rid of recursive definitions and other such blunders is a real pain.
I can easily say that I wouldn’t be anywhere as far into my Japanese studies without your hard work. For someone like me, who was working full time when I bought the cards, they were an amazing time saver and often the only thing I would study from in my earlier days. Cannot appreciate you and your wife’s work enough :)
I always wonder why they chose not to include sample sentences sometimes. A sample sentence is always better.
Recursive definitions are the devil to any J-J learner :P
The quality really shows in these cards. Ive tried learning two different languages before japanese and, from that perspective, the cards are very clearly built with a solid grasp and understanding of how language learning works at a fundemental level. The one thing that drew me to these cards in particular were the world 1 blog posts, detailing the japanese learning journey. I recognized the early excitement, mid level blues, etc from the other language learning attempts and realized that what was being described here were much more universal than they seemed. Then, on hearing about the iterative design of the flashcards, it was clear that they would be made with the same universal understanding of language learning that the blog posts hinted at. I am positive that I wouldnt have kept up with it as long as I have if it hadn’t been for the hard work that you and Yuki have poured into these decks, so thanks a bunch.
I’m glad the posts continue to work and help boost the power of the decks.
Sometimes people actually get the decks (through the app), and then ask me how to study Japanese. And I have to point them to the existence of the blog, which provides a “little more” direction :)
Thank you so much for all your hard work. I recently purchased JALUP Maximum on the iOS app and I’m really enjoying it! It’s so nice to be able to read a sentence and understand it without having to translate it to English in your head, and JALUP is really helping me with switching my thinking to Japanese. This has been worth every penny and I’ll gladly recommend it to anyone! Also, I’ve taken 2 semesters of college Japanese and everyone should note that purchasing JALUP Maximum in less than one semester of college Japanese. JALUP will take you so much farther than just one college class. Thanks again and I can’t wait to learn even more!!
Thanks for your purchase and support Jada!
Now I just need to make a college class out of Jalup :P
This was an really interesting post about the creation of your decks. It‘s a lot more work then I expected, and I already expected lot of work ? the price tag you did choose is absolutly justified for all this work. I really hope the pre-order system will worm out in the future and we will see more and more content :) 10.000 cards total sound awesome ? even though I‘m still in the beginner Deck ? I‘m a slowpoke
10,000 is still very far away. But you never know!
And remember, slowpokes still become fluent.
The further I get into the decks, the more I appreciate everything you have put into them. I just reviewed Intermediate card no 234 where you explain an “easy” word. It must be so hard to find easy J-J definitions for words like eye or cat or similar. Thanks again for everything you do! I never would have learned this much Japanese and had so much fun with it without Jalup. The Maximum package was worth every penny!
Ahh the word 口. Sometimes I get carried away with the simple definitions, like with the word 飛行機 on JI909 :)
Your dedication and effort in helping others to learn japanese continues to amaze me. The cards are excellent and I definitely am making progress with kanji finally due to your kanji kingdom. Thanks again! JALUP definitely is the reason I’ve been able to start studying again and I feel like I actually have a shot at understanding and speaking native japanese.