Hacker News Reader

Comment by rahilb | Hacker News Reader

>continued effort regarding Scala.js

It's a shame the documentation is so poor for scalajs.

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'm about to start using it again, but one point: the installation page[1] doesn't actually tell you how to install it...

[1] http://www.scala-js.org/doc/

Hum, that's because you don't actually need to install Scala.js per se. sbt will download and use it for your project automatically.

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!

For what it's worth, I've found the documentation to be quite good, and easy to follow. Thanks for all of your hard work.

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.

I haven't looked at scala.js, but as a new-ish scala user I thought the kick-off post in that mailing list drama from last month summarized my thoughts pretty well.

I won't argue about the documentation of Scala in general. But a post in the thread you are referring to was specifically mentioning Scala.js as not having the same issues.

Reply on news.ycombinator.com