[Docs] Try Gitbook!

The docs pages reminded me of the
[Gitbook](https://github.com/GitbookIO/gitbook) format, except with the
latter, you wouldn't need to maintain anything yourself.

Here's an example of such doc: http://redux.js.org

`npm run watch` is all you need to set up a watcher that live reflects
your changes to localhost:4000. `npm run build` to publish into _book,
which I put into .gitignore, as I'm not sure how publishing to gh-pages
work.

Author: chenglou

docs/.gitignore

@@ -1,2 +1,3 @@
+.*
 node_modules
-dist/*.html
+_book

docs/Create-a-simple-example-with-NPM.md

@@ -10,21 +10,21 @@ echo "{}" > package.json
 
 First, Install BuckleScript.
 (For more advacned settings, please read
-[Installation](./Installation))
+[Installation](./Installation.md))
 
 
 
 ```sh
-npm install bs-platform --save 
+npm install bs-platform --save
 ```
 
-Second, create a file called `hello.ml`, 
+Second, create a file called `hello.ml`,
 
 ```js
 echo 'let _ = Js.log "hello bucklescript!"' > hello.ml
 ```
 
-Third, build and run 
+Third, build and run
 
 ```
 `npm bin`/bsc -c hello.ml

docs/Installation.md

@@ -2,18 +2,18 @@
 
 To use BuckleScript, you need both, a specific version of the OCaml compiler (tweaked to make BuckleScript possible), and the BuckleScript software itself. The instructions below show how to install both of these using standard package managers as well as how to build from source for Unix/Linux systems. Build directions will be updated once Windows systems are supported.
 
-## Default installation procedure (using package managers) 
+## Default installation procedure (using package managers)
 
-### 1. OCaml compiler from opam (optional) 
+### 1. OCaml compiler from opam (optional)
 
-When working with OCaml we recommend using [opam](https://opam.ocaml.org) package manager, available [here](https://opam.ocaml.org/doc/Install.html). You will benefit from the existing OCaml ecosystem. 
+When working with OCaml we recommend using [opam](https://opam.ocaml.org) package manager, available [here](https://opam.ocaml.org/doc/Install.html). You will benefit from the existing OCaml ecosystem.
 
 Once you have `opam` installed, ask `opam` to switch to using our version of the compiler:
 
 ```sh
 opam update
 opam switch 4.02.3+buckle-1
-eval `opam config env` 
+eval `opam config env`
 ```
 
 > This step is optional. npm installation will build the compiler from source if not installed from opam
@@ -26,7 +26,7 @@ The standard npm package management tool can be used to install BuckleScript. If
 npm install --save bs-platform
 ```
 
-## Advanced installation procedure (from source) 
+## Advanced installation procedure (from source)
 
 BuckleScript has very little dependencies and building from source can easily be done.
 
@@ -71,4 +71,4 @@ MODULE_FLAGS='-js-module commonjs' make world
 MODULE_FLAGS='-js-module goog:buckle' make world
 ```
 
-Also see [Create a simple example with npm](./Create-a-simple-example-with-npm.md)
+Also see [Create a simple example with npm](./Create-a-simple-example-with-NPM.md)

docs/index.md renamed to docs/README.md

@@ -0,0 +1,40 @@
+* [Home](./README.md)
+
+* [Playground](https://bloomberg.github.io/bucklescript/js-demo)
+
+* Get Started
+  * [Installation](./Installation.md)
+  * [Create a simple example with NPM](./Create-a-simple-example-with-NPM.md)
+  * [NPM Support](./NPM-Support.md)
+
+* BuckleScript Basics
+  * [FAQ](./FAQ.md)
+  * [About OCaml](https://ocaml.org/)
+  * [Compiler options](./Compiler-options.md)
+  * [How to adapt your build system](./How-to-adapt-your-build-system.md)
+  * [Extensions to OCaml Language](./Extensions-to-OCaml-Language.md)
+  * [Semantic differences from other backends](./Semantic-differences-from-other-backends.md)
+  * [JavaScript target versions](./JavaScript-target-versions.md)
+
+
+* BuckleScript Overview
+  * [Compiler overview](./Compiler-overview.md)
+
+* BuckleScript FFI
+  * [Runtime representation](./Runtime-representation.md)
+  * [Curry and Uncurry functions](./Curry-and-Uncurry-functions.md)
+  * [JS call OCaml](./JS-call-OCaml.md)
+  * [OCaml call JS](./OCaml-call-JS.md)
+  * [Experimental support of typescript](./Experimental-support-of-typescript.md)
+  * [Unsupported IO primitives](./Unsupported-IO-primitives.md)
+
+* Contributions
+  * [Github Link](https://github.com/bloomberg/bucklescript)
+  * [Dev mode How to](./Dev-mode-How-to.md)
+  * [Help move runtime functions from OCaml to Javascript](./Help-move-runtime-functions-from-OCaml-to-Javascript.md)
+
+* Roadmap
+  * [Roadmap](./Roadmap.md)
+
+* Comparisons
+  * [Differences from js_of_ocaml](./Differences-from-js_of_ocaml.md)

docs/SUMMARY.md

@@ -37,11 +37,11 @@ libraries into small pieces like as done in [lodash](https://github.com/lodash/l
 
    The OCaml compiler implementation(s) are famous for blazing fast compile times, and as programmer, we think compile times really matter and are a very important feature of a compiled language.
 
-    [images/compile-time.png](./images/compile-time.png)
-    
+    ![images/compile-time.png](./images/compile-time.png)
+
    The above picture compares OCaml compilation-times with
    other languages: S for Scala, K for Koltin, TS for TypeScript.
-   
+
    Bucklescript reuses most of the OCaml compiler (parsing/type
    checking and pattern match compilation), its type checker
    [was well engineered](http://okmij.org/ftp/ML/generalization.html)
@@ -131,7 +131,7 @@ We also compare code Size:
 
 ### How is it faster than hand-written JS code?
 
-It's hard to explain JS performances in general, however, we will 
+It's hard to explain JS performances in general, however, we will
 explain some of the optimizations we've done. For example, in OCaml, `Map`
 is like C++ templates, i.e. it will be instantiated by a comparison
 function, like below:
@@ -177,7 +177,3 @@ There are other factors count, mostly code organized in functional
 style are much easier to do the tree shaking while harder to remove
 for OO style, OCaml's standard library and runtime are organized in an
 independent style, which also helps dead code removal.
-
-
-
-