New WaniKani Knowledge Base

Those gifs are so nice.
Great work!

I think your concerns are valid. Since we already get the “it’s so slow” people, I can most definitely see people saying “How come I don’t have that amount of lessons? I want more lessons!”, y’know?

In the Small vs Big Characters page, there’s no mention of つ and っ, and considering how many questions that gets, there probably should be a mention …

“Crabigator I am not worthy that you should update my content, but only say the word and my soul shall be healed.” - Matthew 8:8

Are you sure there’s a book called Matthew in the Bible of Crabigatorism?

Congratulations on making it public on Github!
You know what community is and you prove it!

:+1:

It’s one of the apocrypha.

I had a look, and it seems fine. Possibly a bit easier to navigate than the old FAQ, though I’m not certain.

The first thing that jumps out at me is the word “Onboarding” near the top. That seems excessively like corporate-speak to me. I had to look it up on Google and found that it seems to be a newish word having to do with integrating new employees into a company, which is not what this is.

I’d suggest something more accessible like “orientation” or … “getting started” which, now that I look at it, is already a category in the tutorial section and already includes all the “onboarding series”. I find this confusing.

Other points: Under “Why Do I Need to Wait for Reviews?” There’s an animated gif that is as far as I can tell the only photo/live action video in the whole thing and so seems out of place. Also having it repeat endlessly on my screen as I’m typing this makes me feel like I’m having a seizure. Once per page load might be enough.

The top blue menu bar has three links. The one to wanikani.com is straightforward. The other two links (“WaniKani Knowledge” and “Tutorials”) take me to the same place. This feels broken. Shouldn’t one link be enough if there is only one thing being linked to? Or you could jump down the page to the tutorials section for the “Tutorials” links.

The word “tutorials” implies that you will be guided through a procedure, or answer the question, “How do I do this?” Many of these KB articles don’t do that (e.g. “WaniKani’s SRS Stages”, " Does WaniKani teach stroke order?"). They explain how or why WK functions, but they don’t actually tell you how to do something. Maybe divide the content into tutorials and other information, or just find a more encompassing word.

I used to work in online software support doing both KB editing and tutorials, so this stuff brings out the nit-picker in me.

It’s fine now, but the knowledge base also has to be updated every time something changes, such as new functions or new SRS intervals. Otherwise it’ll become obsolete in no time as well.

That’s just the nature of all documentation, especially for an ongoing project like WK that isn’t divided into versions.

Unless I missed it, it seems like the reading recommendations by level portion is now gone? The one that was along the lines of

Levels:
1-10: You can scan newspapers/manga but don’t really try to read much yet
11-20: You can start reading children’s manga and NHK easy now but don’t get too in depth at this stage
21-30: You can really start to read at this point

Etc. I found it really helpful to have a rough guide for what I could do at my level without wasting my time trying to tackle stuff way above me. Seems like it might be worth making a page just dedicated to recommendations for what to try tackling at your current level range?

Great work! I really like the new updates.

That being said (because I criticize everything), something about the yellow on the top banner makes my eyes skip past it. Maybe I’ve just been well trained by all the banner ads that show up in a similar spot, but my first intuition was to skip completely past it into the sections below it.

Also, like some of the other already mentioned, I have a feeling we’re still going to see a lot of “why is WK so slow” posts. I think it would be really helpful to make the link much more prominent (ie not in the footer of the page). I even had difficulty finding it and I knew what I was looking for. I think the Knowledge Base is of higher importance than being relegated to a place no one will ever look. I think that change alone would go a long way to helping the existing issues.

At the very least, I would like to see the link in the top right menu, but I really think it should get it’s own prominent place on the main page. Something like this:
image

You have some free page real estate next to the search bar that would be perfect for something like this. I really do like the new updates, but we need people to see them if they’re ever going to get used.

I just stumbled on this by accident!

It looks great, is organized well, and pretty darn swell.

EDIT: Let me add here that I love this

but feel that the word “yet” should be italicized.

As a preview:

That is more impactful… and the truth.

Oooh this is awesome :smiley: I also love me some high-quality snark :wink:

I second this! This was very helpful for motivation when I was starting out :slight_smile:

The problem of not updating documentation is pretty bad at WK though.

I dig it. :raised_hands::+1:

Great stuff!

@viet The first time I looked at the repo I was wondering why it would have so few stars and so many forks. Of course, it was easy to realize that it was forked from a base jekyll template.
Did ya’ll consider maintaining the WK repo without it being a fork of the original CloudCannon repo? Not a biggie and I guess changing that would bring a small bit of downtime?

Agree it could be more prominent, but I’d defer to them on where to place it. I don’t think that would be perfect placed next to the search bar because it makes the kanji search look like a knowledge base search.

It’s always easy to throw rocks isn’t it? Or is there something constructive your trying to add to the conversation? What’s your basis of comparison or is this shade-throwing the result of some armchair anecdotal analysis?

Ouch, somebody’s feeling crabby today…