/ src / introduction.md
introduction.md
 1  # Rust 🦀 and WebAssembly 🕸
 2  
 3  This small book describes how to use [Rust][] and [WebAssembly][] together.
 4  
 5  ## Who is this book for?
 6  
 7  This book is for anyone interested in compiling Rust to WebAssembly for fast,
 8  reliable code on the Web. You should know some Rust, and be familiar with
 9  JavaScript, HTML, and CSS. You don't need to be an expert in any of them.
10  
11  Don't know Rust yet? [Start with *The Rust Programming Language* first.][trpl]
12  
13  Don't know JavaScript, HTML, or CSS? [Learn about them on MDN.][mdn]
14  
15  ## How to read this book
16  
17  You should read [the motivation for using Rust and WebAssembly
18  together][why-rust-wasm], as well as familiarize yourself with the [background
19  and concepts][background] first.
20  
21  The [tutorial][] is written to be read from start to finish. You should follow
22  along: writing, compiling, and running the tutorial's code yourself. If you
23  haven't used Rust and WebAssembly together before, do the tutorial!
24  
25  The [reference sections][reference] may be perused in any order.
26  
27  > **💡 Tip:** You can search through this book by clicking on the 🔍 icon at the
28  > top of the page, or by pressing the `s` key.
29  
30  ## Contributing to this book
31  
32  This book is open source! Find a typo? Did we overlook something? [**Send us a
33  pull request!**][repo]
34  
35  [Rust]: https://www.rust-lang.org
36  [WebAssembly]: https://webassembly.org/
37  [trpl]: https://doc.rust-lang.org/book/
38  [mdn]: https://developer.mozilla.org/en-US/docs/Learn
39  [why-rust-wasm]: ./why-rust-and-webassembly.html
40  [background]: ./background-and-concepts.html
41  [tutorial]: ./game-of-life/introduction.html
42  [reference]: ./reference/index.html
43  [repo]: https://github.com/rustwasm/book