rescript-association / reasonml.org

Deprecated in favor of rescript-lang.org
MIT License
125 stars 34 forks source link

BuckleScript into doesn't clarify much about what it is #152

Closed davesnx closed 3 years ago

davesnx commented 4 years ago

The intro lives here: https://reasonml.org/docs/reason-compiler/latest/introduction and looks like that:

BuckleScript isn't a new language. It simply takes OCaml, a fast, pragmatic and typed language, and makes it compile to clean, readable and performant JavaScript code. This allows the users to write in an industrial-strength language while using the existing, familiar JavaScript tools (npm/yarn, bundlers, minifiers, devtools, etc.) and accessing the vast ecosystem from both JavaScript and OCaml.

Thanks to its great interoperability with JS, BuckleScript can be seen as a "gradually" typed language, where you get to incrementally adopt it in your codebase file-by-file, while keeping the full benefits of a 100% sound and reliable type system, plus extra language features.

My honest suggestion:

I would keep the title "The Reason Compiler" and start with. It's called BuckleScript.

And then shuffle this ideas:

ryyppy commented 3 years ago

This will be clarified with ReScript's new elevator pitch