Great article and I also think that it would be helpful to have a "fun-to-learn-from" type of documentation. However wouldn't that up to a certain extent scare away some potential users? People are lazy and having to complete a "course/game" before you're allowed into the main platform, seems like it could cause the lazier ones to be demotivated and "run to the next thing" before they actually get to experience what the platform is really about. Perhaps merging the two would be a better option, in other words you get to see the bigger picture(the main platform) but as you learn more and raise more questions about what you see, you can always go back to the game.