News for hackers. Stuff that matters.
Re:JavaScript right on the hardware by swang on Wednesday August 14, 2013 @06:55PM (#6214941)
> poorly-documented

what?

Re:JavaScript right on the hardware by ahoge on Wednesday August 14, 2013 @08:24PM (#6215403)
There still isn't any language specification, is there?

JavaScript, TypeScript, and Dart have one.

Re:JavaScript right on the hardware by luikore on Thursday August 15, 2013 @05:15AM (#6216830)
But the one-page manual of coffeescript is far more useful to users than those looong specifications. No document about the syntax is better than the annotated source of the parser. And you can find specifications about all kinds of javascript runtimes elsewhere, they document the coffeescript runtime too.
Re:JavaScript right on the hardware by ahoge on Thursday August 15, 2013 @06:53AM (#6217075)
Language specifications are important for interoperability. They are very useful for people who write tools like smart IDEs or linters. They are also interesting for people who want to create their own VM or compiler. There are various JavaScript and Java VMs. There are also various C and C++ compilers.

But there are also users who read them if they think that some particular behavior is puzzling. Then they check the spec to see if this stuff really is supposed to happen or if this is something which wasn't properly specified.

For example, there was a 50:50 split when it came to the behavior of SVG masking. As it turned out, that part of the spec was just confusingly written and the compliant behavior was actually really silly. The spec was changed and now every browser does the same intuitive thing.

Without this "central authority" there wouldn't have been a way to get this fixed.

Dart is another interesting example. They had a specification since the beginning and every part of the ecosystem follows it. This way, different teams (and even different companies) can create all kinds of tools which all have the same precise understanding of the language. Naturally, this also helps with identifying spec issues.

Without a specification, you have to reverse-engineer the behavior and you might end up being forced to replicate some really nasty crap. Some of JavaScript's warts were set in stone this way.

Re:JavaScript right on the hardware by vinceguidry on Wednesday August 14, 2013 @07:56PM (#6215289)
Who needs documentation when you can just pop open a REPL and copy-paste your functions to see how they compile?
Re:JavaScript right on the hardware by fordi on Wednesday August 14, 2013 @09:52PM (#6215692)
People who don't know javascript.