diff --git a/.gitignore b/.gitignore
index 1f5aa33552..1f90ef6ecd 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,6 +1,7 @@
**/node_modules/
**/*.log
test/repo-tests*
+**/bundle.js
# Logs
logs
@@ -35,4 +36,4 @@ lib
dist
test/test-data/go-ipfs-repo/LOCK
test/test-data/go-ipfs-repo/LOG
-test/test-data/go-ipfs-repo/LOG.old
\ No newline at end of file
+test/test-data/go-ipfs-repo/LOG.old
diff --git a/README.md b/README.md
index 9817c736cd..e8953f17c0 100644
--- a/README.md
+++ b/README.md
@@ -7,59 +7,28 @@
The JavaScript implementation of the IPFS protocol.
-
-
-
-
-
-
-
-
-
+
+
+
-
-
-
-
-
-
-
-
-
+
+
+
-
-
-
-
-
-
-
-
-
+
+
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+ -->
### Project status
@@ -138,18 +107,17 @@ In order to use js-ipfs as a CLI, you must install it with the `global` flag. Ru
$ npm install ipfs --global
```
-The CLI is available by using the command `jsipfs` in your terminal. This is aliased, instead of using `ipfs`, to make sure it does not conflict with the Go implementation.
-
-### Use in the browser with browserify, webpack or any bundler
+The CLI is available by using the command `jsipfs` in your terminal. This is aliased, instead of using `ipfs`, to make sure it does not conflict with the [Go implementation](https://github.com/ipfs/go-ipfs).
-You can find examples of how to do this bundling at: `https://github.com/ipfs/js-ipfs/tree/master/examples`. If you are using webpack, make sure to use version 2 or above, otherwise it won't work.
+### Use in the browser
-### Use in a browser using a script tag
+##### With browserify, webpack or any bundler
-Loading this module in a browser (using a `
+