Setup melange page

docs/compiling-to-js-with-melange.md

@@ -1,58 +1,93 @@
 ---
-title: Compiling to JavaScript with Melange
+title: Melange
 ---
 
-After the installation page, we have a CLI application written in Reason, running a native executable, but one of the best usages of Reason is to compile it to JavaScript an run it in the browser or any JavaScript platform such as Node, Deno Cloudflare Workers,
+One of the best usages of Reason is to compile it to JavaScript an run it in the browser or any JavaScript platform such as [Node.js](https://nodejs.org), [Deno](https://deno.com), [Cloudflare Workers](https://workers.cloudflare.com).
 
-To do so, we need to introduce [Melange](https://melange.re).
+Reason compiles to JavaScript thanks to our partner project, [Melange](https://melange.re).
 
-## Melange
+## What's Melange?
 
-[Melange](https://melange.re) is a backend for the OCaml compiler that emits readable, modular and highly performant JavaScript code. It's not the only option, there are other alternatives such as [Js_of_ocaml](compiling-to-js-with-jsoo.md).
+[Melange](https://melange.re) is a backend for the OCaml compiler that emits readable, modular and highly performant JavaScript code.
 
-If you have experience with JavaScript and it's ecosystem we recommend Melange.
+> Melange strives to provide the best integration with both the OCaml and JavaScript ecosystems
 
-<!-- Turn it into a quote -->
-From their docs
-> Melange strives to provide the best integration with both the OCaml and JavaScript ecosystems. To learn all about melange go to their documentation.
+If you have experience with JavaScript and the ecosystem we recommend Melange, over other alternatives such as [Js_of_ocaml](compiling-to-js-with-jsoo.md).
+
+## Getting started
+
+The install guide on the Melange website shares a lot of common steps with [our installation](installation.md), check it out: [melange.re/v2.0.0/getting-started](https://melange.re/v2.0.0/getting-started).
+
+Since [Melange v1](https://buttondown.email/anmonteiro/archive/melange-hits-v10/), it integrates with dune, the OCaml build system. This means that you can use dune to compile
 
 ## Template
-<!-- To get started with Reason and Melange, there's an official template
 
-```
-git clone https://github.com/melange-re/melange-esy-template
-cd melange-esy-template
-esy
+To get started with Reason and Melange, there's an official template:
+
+```bash
+git clone https://github.com/melange-re/melange-opam-template
+cd melange-opam-template
+
+# Create opam switch and install dependencies
+make init
 
-npm install
-npm run webpack
+# In separate terminals:
+
+make watch # Watch for reason file changes and recompile
+make serve # Run the development server
 ```
--->
 
 ## Manual
 
-If you prefer to do all the steps manually, here is a step by step.
+If you prefer to do all the steps manually, here is a step by step. Assuming you have an opam switch with OCaml 5.1.0. If not, check the [installation](installation.md#setup-a-new-environment-manually) guide.
 
 #### Install melange
 ```sh
-esy add @opam/melange
+opam install melange
 ```
 
 #### Create dune-project
-```clojure
+
+If you don't have a dune-project file, create one with the following content:
+
+```lisp
 ; dune-project
 (dune lang 3.8)
-(use melange 0.1)
+(use melange 0.1) ; Here we enable melange to work with dune
 ```
 
 #### Emit JavaScript
-- Create a dune file
-- Add melange.emit stanza
-```clojure
+
+In your dune file, add `melange.emit` stanza to emit JavaScript.
+
+The `melange.emit` stanza tells dune to generate JavaScript files from a set of libraries and modules. In-depth documentation about this stanza can be found in the [build-system on the Melange documentation](https://melange.re/v2.0.0/build-system/#entry-points-with-melangeemit).
+
+```lisp
 ; dune
 (melange.emit
-  (target ???)
-  ()
+ (target app))
+```
+
+#### Compile
+
+Each time you compile the project, dune will emit JavaScript files under `_build/default/app/` (`app` comes from the `(target app)` defined under `melange.emit`).
+
+To compile the project, run:
+
+```bash
+dune build # Compile the entire project
+# or compile the melange alias (only melange.emit stanzas)
+dune build @melange
+```
+
+#### Libraries
+
+dune allows to define libraries by creating a dune file inside a folder and adding a library stanza: https://dune.readthedocs.io/en/stable/concepts/package-spec.html#libraries
+
+To compile a library with melange, add the `(modes melange)` stanza to the library dune file.
+
+```diff
+(library
++ (modes melange)
 )
 ```
-<!-- Link to all options in Melange -->

website/i18n/en.json

@@ -18,10 +18,10 @@
         "title": "Community"
       },
       "compiling-to-js-with-jsoo": {
-        "title": "Compiling to JavaScript with Js_of_ocaml"
+        "title": "Js_of_ocaml"
       },
       "compiling-to-js-with-melange": {
-        "title": "Compiling to JavaScript with Melange"
+        "title": "Melange"
       },
       "converting-from-js": {
         "title": "Converting from JS"

website/sidebars.json

@@ -33,7 +33,6 @@
     ],
     "JavaScript": [
       "compiling-to-js-with-melange",
-      "compiling-to-js-with-jsoo",
       "interop",
       "syntax-cheatsheet",
       "pipe-first",