Add code example from crate docs to readme, use readme in crate docs

In order to simplify documentation, this commit moves most of the
documentation directly into the README.md. Additionally, to avoid
duplication, this commit pulls in the README.md into the crate docs.
This allows one source of truth for documentation and a common
experience between viewing the crate on github, crates.io, and docs.rs.

README.md

@@ -24,7 +24,32 @@ layer.
 
 Documentation is available on [Docs.rs](https://docs.rs/message_verifier).
 
-### Examples
+
+### A Small Example
+
+```
+ extern crate message_verifier;
+
+ use message_verifier::{Verifier, Encryptor, AesHmacEncryptor, DerivedKeyParams};
+
+ fn main() {
+     let key_base = "helloworld";
+     let salt = "test salt";
+     let sign_salt = "test signed salt";
+
+     let verifier = Verifier::new(key_base);
+
+     //let dkp = DerivedKeyParams::default();
+     //let encryptor = AesHmacEncryptor::new(key_base, salt, sign_salt, dkp).unwrap();
+
+     let message = "{\"key\":\"value\"}";
+
+     println!("{}", verifier.generate(message).expect("Verifier failed"));
+     //println!("{}", encryptor.encrypt_and_sign(message).expect("Encryptor failed"));
+ }
+```
+
+### More Examples
 
 The examples directory contains two Rust examples as well as two small
 Ruby scripts to demonstrate interoperability between this library and
@@ -72,3 +97,4 @@ If you need more cipher options, please open an issue or submit a PR!
 
 - [mjc-gh](https://github.com/mjc-gh/)
 - [seanlinsley](https://github.com/seanlinsley)
+- [endoze](https://github.com/endoze)

src/lib.rs

@@ -1,34 +1,5 @@
-//! Message Verifier library compatible with Rails'
-//! [MessageVerifier](http://api.rubyonrails.org/classes/ActiveSupport/MessageVerifier.html) and
-//! [MessageEncryptor](http://api.rubyonrails.org/classes/ActiveSupport/MessageEncryptor.html).
 //!
-//! #### A Small Example
-//!
-//! Please refer to the
-//! [README](https://github.com/mikeycgto/message_verifier/blob/master/README.md)
-//! and [repo](https://github.com/mikeycgto/message_verifier) for more examples.
-//!
-//! ```
-//!  extern crate message_verifier;
-//!
-//!  use message_verifier::{Verifier, Encryptor, AesHmacEncryptor, DerivedKeyParams};
-//!
-//!  fn main() {
-//!      let key_base = "helloworld";
-//!      let salt = "test salt";
-//!      let sign_salt = "test signed salt";
-//!
-//!      let verifier = Verifier::new(key_base);
-//!
-//!      //let dkp = DerivedKeyParams::default();
-//!      //let encryptor = AesHmacEncryptor::new(key_base, salt, sign_salt, dkp).unwrap();
-//!
-//!      let message = "{\"key\":\"value\"}";
-//!
-//!      println!("{}", verifier.generate(message).expect("Verifier failed"));
-//!      //println!("{}", encryptor.encrypt_and_sign(message).expect("Encryptor failed"));
-//!  }
-//! ```
+#![doc = include_str!("../README.md")]
 
 #[macro_use]
 extern crate error_chain;