Merge pull request #55 from Turbo87/rustdoc-readme

Use `README.md` as module doc comment

README.md

@@ -37,9 +37,9 @@ Usage
 ------------------------------------------------------------------------------
 
 ```rust
-fn main() {
- let manifest = Manifest::from_path("Cargo.toml").unwrap();
-}
+use cargo_manifest::Manifest;
+
+let manifest = Manifest::from_path("Cargo.toml").unwrap();
 ```
 
 see [docs.rs](https://docs.rs/cargo-manifest) for more information.

src/lib.rs

@@ -1,8 +1,6 @@
 #![allow(clippy::large_enum_variant)]
-//! This crate defines `struct`s that can be deserialized with Serde
-//! to load and inspect `Cargo.toml` metadata.
-//!
-//! See `Manifest::from_slice`.
+#![doc = include_str!("../README.md")]
+
 use serde::Deserializer;
 use serde::{Deserialize, Serialize, Serializer};
 use std::collections::BTreeMap;