Add docs

Fixes solana-labs#11

Cargo.toml

@@ -1,7 +1,7 @@
 [package]
 name = "silk"
 description = "A silky smooth implementation of the Loom architecture"
-version = "0.1.3"
+version = "0.2.0"
 documentation = "https://docs.rs/silk"
 homepage = "http://loomprotocol.com/"
 repository = "https://github.com/loomprotocol/silk"

README.md

@@ -15,6 +15,30 @@ corresponding benchmarks are also added that demonstrate real performance boots.
 feature set here will always be a ways behind the loom repo, but that this is an implementation
 you can take to the bank, literally.
 
+# Usage
+
+Add the latest [silk package] (https://crates.io/crates/silk) to the `[dependencies]` section
+of your Cargo.toml.
+
+Create a *Historian* to create a *Proof-of-History* and then verify in parallel:
+
+```rust
+use historian::Historian;
+use log::{Event, verify_slice};
+
+fn main() {
+    let hist = Historian::new(0);
+
+    hist.sender.send(Event::Tick).unwrap();
+    let entry0 = hist.receiver.recv().unwrap();
+
+    hist.sender.send(Event::UserDataKey(0xdeadbeef)).unwrap();
+    let entry1 = hist.receiver.recv().unwrap();
+
+    assert!(verify_slice(&[entry0, entry1], 0));
+}
+```
+
 # Developing
 
 Building