Merge pull request #45 from David-OConnor/docs

Guide skeleton

Author: fitzgen

.gitignore

@@ -1,3 +1,5 @@
 /target
 **/*.rs.bk
 Cargo.lock
+
+guide/book

CONTRIBUTING.md

@@ -141,6 +141,8 @@ Here is a checklist that all Gloo utility crates should fulfill:
 
 * [ ] Crate's root module documentation has at least one realistic example.
 
+* [ ] Crate has at least a brief description of how to use it in the Gloo guide.
+
 [unwrap-throw]: https://docs.rs/wasm-bindgen/0.2.37/wasm_bindgen/trait.UnwrapThrowExt.html
 [api-guidelines]: https://rust-lang-nursery.github.io/api-guidelines/
 

guide/book.toml

@@ -0,0 +1,5 @@
+[book]
+authors = ["The Rust and WebAssembly Working Group"]
+multilingual = false
+src = "src"
+title = "Gloo Guide"

guide/src/SUMMARY.md

@@ -0,0 +1,6 @@
+# The Gloo Guide
+
+- [Introduction](./introduction.md)
+- [Using Gloo crates](./using-gloo.md)
+- [Timers](./timers.md)
+- [Console-timer](./console-timer.md)

guide/src/console-timer.md

@@ -0,0 +1 @@
+## Console Timer

guide/src/introduction.md

@@ -0,0 +1,14 @@
+# Introduction
+
+Welcome to the Gloo Guide, an introductory guide about [Gloo](https://github.com/rustwasm/gloo).
+Gloo is a toolkit for building web applications and libraries with Rust and Wasm, composed of 
+modular crates. [Gloo crates](https://github.com/rustwasm/gloo/tree/master/crates)
+include example code, both in their respective `example` folders, and commented in their code, as well
+as [API documentation](https://docs.rs/gloo/). The purpose of this guide is to complement these 
+by providing narritive description, 
+and step-by-step of how to use Gloo and its crates.
+ 
+This guide assumes familiarity with the [Rust language](https://www.rust-lang.org/), and web programming. 
+If you'd like to learn Rust,
+check out the [Rust Book](https://doc.rust-lang.org/book/index.html). The [MDN web docs](https://developer.mozilla.org/en-US/)
+is a good reference for web programming.

guide/src/timers.md

@@ -0,0 +1 @@
+## Timers

guide/src/using-gloo.md

@@ -0,0 +1 @@
+## Using Gloo crates