The redesign is live

The redesign of WordSwing's website is now live.

Mobile screehsnot

What's different?

  1. It's mobile. Finding enough time to practice a language is always a challenge. Finding enough time in front of a desktop or laptop is even harder. Now that WordSwing works on mobile devices, you can take advantage of free moments when you're out and about, standing in line, waiting for a plane, riding the bus, etc.

  2. It's faster. Architectural changes to WordSwing enabled us to make the site much faster to download. This should make the load time fast enough for mobile devices. For those interested in technical details, we now serve the main application bundle using a content-delivery network that caches the files at network edge locations near you, and serve compressed files when possible.

  3. There's a whole new drill down interface. At the crux of WordSwing is the ability to drill down to learn more about language you encounter while practicing. Part of this redesign was to completely revamp the drill down interface. The old implementation required tedious mouse-hovering acrobatics to select which language component you wanted to focus on. Now we have an easy touch/drag based highlighting mechanism to quickly get to characters, words, and phrases of interest.

Why'd it take so long?

There are two answers, depending on what is meant by the question.

One answer relates to why didn't we start sooner? We whole-hartedly agree, mea culpa. Four years ago Olle was already exposing the tremendous value of learning Chinese via smartphone. Unfortunately, in an attempt to rapidly prototype and build out WordSwing's language practice functionality we made some design decisions that were at odds with touch-based access. In this rewrite, we've tried to rethink everything from a mobile-first perspective and do it right.

The other answer relates to why did the rewrite take so long? This rewrite has been occupying much of our development efforts for the past 6 months. Six months ago, when I was evaluating whether to do a rewrite I came across a blog post by Joel Spolsky (creater of StackOverflow and Trello), appropriately titled Things You should never do, part I, which discusses why a rewrite is a terrible idea. So I set out not to do a rewrite, but as I broke more and more of of my development copy of WordSwing trying to rearchitect, I got sucked in and there was no going back. What you'll now find at WordSwing is a redesign, that while not a full rewrite, still involved touching nearly all of the 80,000 lines of code that underpin WordSwing.

So, sorry this took so long! I've learned my lesson, and will try to never do it again.

What can we expect going forward?

Most importantly it means back to forward progress, and not only on software development, but also growing WordSwing's language learning content, and improving the machine-learning and modeling behind WordSwing.

From now on it should be possible to make incremental improvements, even major ones, without halting progress on all other fronts. Part of this is that the main client-side web framework I use, Ember.js, has evolved to have a very mature development cycle, complete with a set of staged release channels, semantic versioning, stability guarantees, a well-honored depracation policy, and backed by a great community of developers. This combined with architectural changes I made during this rewrite means that development should be relatively smooth sailing.

Thanks for you patience! And if you haven't checked out WordSwing in a while, please do! And don't forget to let me know what you think.


Learning Chinese characters the most common first

With thousands of Chinese characters to master, it can be daunting to get going and plough through them.

To help you out a bit, we would like to introduce WordSwing's frequency-ordered spaced repetition gadget:

SRS activity screenshot

This gadget will introduce the most frequent 870 Chinese characters in descending frequency order, that is, the most common ones first.

Learning characters in frequency order allows you to benefit from the very steep cumulative frequency curve intrinsic to the Chinese language. I'll illustrate with a plot from WordSwing's Character Knowledge Estimator:

SRS activity screenshot

This plot illustrates how the number of characters you know (horizontal axis) relates to the fraction of typical text that is comprised of those characters (vertical axis). This curve is drawn assuming that the probability you know a character is proportional to the frequency of the character. So in the plot above, if you know 870 characters then you can recognize the characters comprising 79% of typical text.

Now, if you learn the characters in strict frequency order then the curve is even slightly steeper. Thus, if you go through all 870 characters that are part of our new Frequency-ordered SRS gadget then you will actually know characters corresponding to 86% of typical text. In contrast, if you were to just pick 870 characters completely at random from the ~5000 or so most common characters, on average these would comprise only 9% of typical text. So it's really worth focusing on the common ones first.

By learning the 870 most common characters, you get 86% of typical text, with a random batch of 870 characters you would only get 9%!

Why yet another SRS tool?

Spaced repetition is one of the most powerful tools in the vocabulary learning toolbox. If you're not familiar with it, check out Hacking Chinese's introduction to SRS.

WordSwing's version of spaced repetition works much like the popular Anki spaced repetition program, although our version is not designed as a general purpose tool.

Instead, it's optimized to the task of learning Chinese characters. There are a number of features that make it particularly well-suited to character learning:

  1. As characters are introduced, common words that are comprised solely of already-introduced characters will be added to the mix. Adding words along the way allows you to practice the characters in the context of the words in which they are used, giving your brain more fodder for building associations.
  2. When you review a composite word, like 学生, if you indicate that you still remember it, then this also affects the review intervals for 学 and 生. In this way we leverage the intrinsic structure of the language to reduce the number of card views to get all vocabulary items to the highest review stage. However, if you indicate you don't remember 学生 then this doesn't affect the review intervals for 学 or 生 because it's not clear which part you forgot or whether you simply forgot that those two characters form this word.
  3. At each iteration, you explicitly choose whether you want to introduce a new character, review an item, or introduce a new word. This gives you full control over the balance of new material and keeping your review queue manageable.
  4. The gadget is wired up to the rest of WordSwing, so you have immediate access to related words, character decompositions, example sentences etc. By taking a moment to drill down and explore a word, you're giving your brain a chance to make additional associations that will help embed the new vocabulary item in your long-term memory.

We hope you enjoy our new gadget and, as always, welcome any and all feedback you have.

Have fun learning!

Help direct our development

One of the fun challenges at WordSwing is that we have a mile-long development to-do list. But rather than let our (perhaps misguided whim) dictate what gets done when, we want to involve our students in the process.

Now you can help direct our development priorities by voting on cards on the WordSwing Development Board. You can also participate in a discussion surrounding each card in the comments.

WordSwing development board

And if you have ideas for cards you'd like to see added, please email us.

You'll find several lists of cards, each with a different purpose. There's a list for bite-size ideas, one for massive projects, and then there are several lists that allow you to follow your favorite feature through the development process from active development, to testing, to release.

You can also subscribe to cards, lists, or the whole board, which will send you email updates about changes. This will let you get notified when a new feature lands so you can go check it out. A good place to start is the card explaining how the board works.

We hope this will enable us to better serve your learning goals by developing the parts you most need earliest.

Hope to see you on the WS Dev Board!

How do I get started practicing with WordSwing?

You've just signed up to WordSwing, now what?

The fastest way to get started practicing Chinese is to dive in and try and an activity.

Some of the activities will work well right off the bat, without providing the learning machine any information about your knowledge of Chinese. These activities include:

Preamble / Follow-up: You're given a sentence in English that provides some situational context for what you're about to read. This is the preamble. Then you can read the follow-up in Chinese. This is a sentence that you might expect to hear in that situation. The idea is the preamble will prime your expectation of what you might hear, and because you need to work to figure out what the sentence means, and make some educated guesses, you will be more likely to learn from the process, rather simply reading a provided translation. You can also learn more about any given character or word by [Drilling down]( Many of the follow-ups have audio recordings, so you can also practice your listening comprehension.
Asking Directions: Ever felt like you needed to ask for directions but had trouble understanding the reply? This activity will give you ample practice parsing and interpreting responses. Each step along your route, you will hear one set of instructions and need to make a choice about which way to turn. Think you can reach your destination? You can either listen to the audio or try reading each directional step.
Fill in the Missing Tones: The tone of a syllable is an essential distinguishing characteristics of a syllable. Need more practice challenging your ability to recognize spoken tones? In this activity you listen to sentences and fill in the missing tones. You can tune the difficulty of the sentence to however challenging you want to make it.

Other activities work best once the learning machine has had a chance to get a sense of which words you know and don't know. The learning machine will learn this in the ordinary course of using WordSwing. But you can effectively jump-start the process by using the rating tool to quickly rate a bunch of words, giving WordSwing an early glimpse of you language knowledge.

Once you have rated a bunch of words (maybe 30-40), you'll be ready to try out the activities for which exercise proposals are more closely based on your precise knowledge of Chinese. These include:

Character Combinations: Think you know characters well? Try recognizing, out of context, which two characters out of four can form a valid word. This activity forces you to reach back into your head and dig around for whether you've seen certain characters in combination.
Pronunciation Recall: A good test of whether you really recognize a word is whether you can write the pinyin given just the written Chinese. Practice this to your heart's content.
Character Similarity: Think you really know that character? It's one thing to recognize a character with a bunch of context. It's another thing entirely to see two visually similar characters and see if you can tell which is which. This activity will not only build your character knowledge, but it will help you build general pattern recognition skills that will improve your overall ability to quickly identify and remember characters.

Want step by step instructions?

You can select which activities you want to study by clicking on Select on the navigation menu:

Navigation bar screenshot

You will get a bunch of activity choices:

Select an activity screenshot

Here you can toggle which activities will show up in your learn stream. A mixture of all the selected activities will be included. In the above screen shot, three activities highlighted in blue are enabled. To practice just one activity, double tap on that one and only it will be selected.

When you're ready to practice, hit the play button (or on the navigation bar):

Go practice screenshot

In addition to the small activities that can be combined into your learn stream, there are also dedicated study activities:

Focus study activities screenshot

These fit less well into the learn stream and so are available as independent activities.

Have fun practicing Chinese!

Page: 8 of 10

Learn a language by swinging up to ever higher levels of proficiency by effectively using the language you've learned so far.

Keep up to date