aboutsummaryrefslogtreecommitdiff
path: root/src
diff options
context:
space:
mode:
authorJake Goulding <jake.goulding@gmail.com>2017-02-09 10:12:23 -0500
committerJake Goulding <jake.goulding@gmail.com>2017-02-09 10:12:23 -0500
commit73322a892bc4344cf1de0a48f4aebc53d3689575 (patch)
treefc1a516874c05847e9bb2051c5c32e23e60c54fa /src
parent297bfb1501b7b4787a1a12783424fa43f2994d78 (diff)
downloadmilf-rs-73322a892bc4344cf1de0a48f4aebc53d3689575.tar.gz
milf-rs-73322a892bc4344cf1de0a48f4aebc53d3689575.zip
Tighten up the crate-level docs
Diffstat (limited to 'src')
-rw-r--r--src/lib.rs23
1 files changed, 12 insertions, 11 deletions
diff --git a/src/lib.rs b/src/lib.rs
index d2034e7..87e090d 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -2,8 +2,8 @@
//!
//! [TOML]: https://github.com/toml-lang/toml
//!
-//! This library implements a [TOML] v0.4.0 compatible parser. This crate also
-//! primarily supports the [`serde`] library for encoding/decoding support to
+//! This library implements a [TOML] v0.4.0 compatible parser,
+//! primarily supporting the [`serde`] library for encoding/decoding
//! various types in Rust.
//!
//! TOML itself is a simple, ergonomic, and readable configuration format:
@@ -37,8 +37,8 @@
//! }
//! ```
//!
-//! You'll note that TOML is very similar to JSON with the notable addition of a
-//! `Datetime` type. In general TOML and JSON are interchangeable in terms of
+//! TOML is similar to JSON with the notable addition of a `Datetime`
+//! type. In general, TOML and JSON are interchangeable in terms of
//! formats.
//!
//! ## Parsing TOML
@@ -53,14 +53,15 @@
//! assert_eq!(value["foo"].as_str(), Some("bar"));
//! ```
//!
-//! The `Value` type implements a number of convenience methods and traits,
-//! where the example above is using `FromStr` to parse a `str` into a `Value`.
+//! The `Value` type implements a number of convenience methods and
+//! traits; the example above uses `FromStr` to parse a `str` into a
+//! `Value`.
//!
//! ## Deserialization and Serialization
//!
-//! This crate currently supports [`serde`] 0.9 with a number of
+//! This crate supports [`serde`] 0.9 with a number of
//! implementations of the `Deserialize`, `Serialize`, `Deserializer`, and
-//! `Serializer` traits. Namely, you'll find in this crate:
+//! `Serializer` traits. Namely, you'll find:
//!
//! * `Deserialize for Value`
//! * `Serialize for Value`
@@ -71,8 +72,8 @@
//! * `Serializer for ser::Serializer`
//! * `Deserializer for Value`
//!
-//! This notably means that you can use Serde to deserialize/serialize the
-//! `Value` type as well as the `Datetime` type in this crate. Similarly you can
+//! This means that you can use Serde to deserialize/serialize the
+//! `Value` type as well as the `Datetime` type in this crate. You can also
//! use the `Deserializer`, `Serializer`, or `Value` type itself to act as
//! a deserializer/serializer for arbitrary types.
//!
@@ -112,7 +113,7 @@
//! }
//! ```
//!
-//! Similarly you can serialize types in a similar fashion:
+//! You can serialize types in a similar fashion:
//!
//! ```rust
//! #[macro_use]