Nit fixes

Signed-off-by: Ana Hobden <operator@hoverbear.org>

Author: Hoverbear

README.md

@@ -3,9 +3,10 @@
 [![Build Status](https://travis-ci.org/tikv/client-rust.svg?branch=master)](https://travis-ci.org/pingcap/client-rust)
 [![Documentation](https://docs.rs/tikv-client/badge.svg)](https://docs.rs/tikv-client/)
 
-> Currently this crate is experimental and some portions (e.g. the Transactional API) are still in active development. You're encouraged to use this library for testing and help us find problems!
+> Currently this crate is experimental and some portions (e.g. the Transactional API) are still in active development. You're encouraged to use this library for testing and to help us find problems!
 
-This crate provides Rust bindings to [TiKV](https://github.com/tikv/tikv), a distributed transactional Key-Value database written in Rust.
+This crate provides a clean, ready to use client for [TiKV](https://github.com/tikv/tikv), a
+distributed transactional Key-Value database written in Rust.
 
 With this crate you can easily connect to any TiKV deployment, interact with it, and mutate the data it contains.
 
@@ -25,13 +26,14 @@ tikv-client = "~0.1"
 
 ## Access the documentation
 
-We recommend using the autogenerated to browse and understand the API. We've done our best to include ample, tested, and understandable examples.
+We recommend using the cargo-generated documentation to browse and understand the API. We've done
+our best to include ample, tested, and understandable examples.
+
+You can visit [docs.rs/tikv-client](https://docs.rs/tikv-client/), or build the documentation yourself.
 
 You can access the documentation on your machine by running the following in any project that depends on `tikv-client`.
 
 ```bash
 cargo doc --package tikv-client --open
 # If it didn't work, browse file URL it tried to open with your browser.
 ```
-
-Otherwise, you can visit [docs.rs/tikv-client](https://docs.rs/tikv-client/).

src/lib.rs

@@ -19,8 +19,8 @@
 //! > in active development. You're encouraged to use this library for testing and help us find
 //! > problems!
 //!
-//! This crate provides Rust bindings to [TiKV](https://github.com/tikv/tikv), a distributed
-//! transactional Key-Value database written in Rust.
+//! This crate provides a clean, ready to use client for [TiKV](https://github.com/tikv/tikv), a
+//! distributed transactional Key-Value database written in Rust.
 //!
 //! With this crate you can easily connect to any TiKV deployment, interact with it, and mutate the
 //! data it contains.
@@ -52,8 +52,8 @@
 //! This crate offers both [**raw**](raw/index.html) and
 //! [**transactional**](transaction/index.html) APIs. You should choose just one for your system.
 //!
-//! The *consequence* of supporting transactions is increased overhead of coordination with `pd`
-//! for timestamp acquisition. This is approximately 1 RTT.
+//! The *consequence* of supporting transactions is increased overhead of coordination with the
+//! placement driver for timestamp acquisition. This is approximately 1 RTT.
 //!
 //! *While it is possible to use both APIs at the same time, doing so is unsafe and unsupported.*
 //!
@@ -62,7 +62,7 @@
 //!
 //! ### Transactional
 //!
-//! The [transactional](transaction/index.html) API supports **transactions** via Multi-View
+//! The [transactional](transaction/index.html) API supports **transactions** via Multi-Version
 //! Concurrency Control (MVCC).
 //!
 //! **Best when you mostly do** complex sets of actions, actions which may require a rollback,
@@ -78,7 +78,7 @@
 //! transactional abilities.
 //!
 //! **Best when you mostly do** single row changes, and have very limited cross-row (eg. foreign
-//! key) requirements.
+//! key) requirements. You will not be able to use transactions with this API.
 //!
 //! ```rust
 //! use tikv_client::{*, raw::*};