mootools documentation is fine. It's just different and therefore "harder". Has nothing to do with your ability to "ship" it's you're lack of knowledge of the library that's the problem. Not the library.
If you can't work a saw it doesn't mean the saw sucks and scissors work better. It means you can't work a saw.
that was probably a bad analogy but I can't think of any better one atm.
'mootools documentation is fine. It's just different and therefore "harder"'
I think I know what you mean, the docs are mostly a reference documentation from what it seems.
But the learning curve is steeper, especially with lack of documentation focused on the beginner.
I know, Django docs are similar (but less worse in this aspect). Still, when you finish the tutorial you don't know where to head.
That's where jQuery shines, it takes you through every step, not to mention it's easier to understand. Hence, more plugins and more users.
"It means you can't work a saw". At this day and age, "saw manufacturers" have to be concerned about the easy of use of the saw.
Of course this is an analogy, because js tools are "free", but it's still a nice idea to go for the better cost x benefit in terms of capabilities/community/libraries etc.
If you can't work a saw it doesn't mean the saw sucks and scissors work better. It means you can't work a saw.
that was probably a bad analogy but I can't think of any better one atm.