Could you elaborate on specific points that would require improvements? Most feedback I receive says it's good. If those of you who think it's poor only tell us "it's poor", there is nothing we can do to improve it.
I agree that the way it is presented on that page is confusing, though. I'll add some explanation about that when I get back from conferences.
Thanks for the feedback!
Having said that, I agree it would be good to hear more from people who dislike the current documentation. Scala.js is a great project, and so it seems worthwhile to make any documentation changes that would make it accessible to as wide an audience as possible.