GitBook

[SamyPesse]

This PR switches the book over to the gitbook format, simplifying the build process and setup 📖 💥 .

You can test it using:

# Install GitBook
$ npm i gitbook -g

# Install plugins
$ gitbook install

# Build and preview the book
$ gitbook serve

[jehoshua02]

I know the gitbook docs instruct to install gitbook globally, but is it possible to install it as a project dependency? You don't want to write the book against one version of gitbook and build with a non-backward compatible version later. Installing it globally, other developers have no idea what version of gitbook was originally used.

[AaronO]

@jehoshua02 Answered you here : GitbookIO/gitbook#554

[sindresorhus]

I also have big concerns about having to install gitbook only globally: GitbookIO/gitbook#554 (comment)

[AaronO]

@sindresorhus By the way GitBook 2.0.0 that's now released supports granular versions.

Are you still interested in this PR ? You would get automatic builds for free (no hassle).

[sindresorhus]

@AaronO Good choice. Yeah, definitely :)