diff --git a/README.md b/README.md
index fc2ed919..86a31b9b 100644
--- a/README.md
+++ b/README.md
@@ -71,13 +71,24 @@ Winit provides the following features, which can be enabled in your `Cargo.toml`
#### WebAssembly
-Building a binary will yield a `.js` file. In order to use it in an HTML file, you need to:
+Winit supports compiling to the `wasm32-unknown-unknown` target with either a
+`stdweb` or a `web-sys` backend for use on web browsers. However, please note
+that **the `stdweb` backend is being deprecated and may be removed in a future
+release of Winit**. The `web-sys` backend is also more feature complete.
-- Put a `` element somewhere. A canvas corresponds to a winit "window".
-- Write a Javascript code that creates a global variable named `Module`. Set `Module.canvas` to
- the element of the `