"the documentation describes the API in TypeScript, and then provides no examples at all! So the average JavaScripter can’t understand what the API looks like"

And:

"Add into the mix the way the documentation casually drifts into hard-core Computer Science and algorithmic discussions at inappropriate places, and you’re left with documentation that only the documentation’s auto-generator understands.

Don’t believe me? Just see this example describing Map, one of the most-used Immutable data structures:

Immutable Map is an unordered Iterable.Keyed of (key, value) pairs with O(log32 N) gets and O(log32 N) persistent sets.

OK. Er, of course it is."

If you don't know what you're doing, and you just want to know how to do it, everyone ends up suffering. And I don't know much about Typescript, but isn't it javascript with types? If the average javascripter can't figure out what's going on there...