Get the README and root documentation a bit more ready for primetime
We're at the point where this can be judged for what it is. We don't
need the design explanation and "please help try it out" bit.
I also want to make sure that anyone who clicks documentation from
crates.io has an easy way to reach the getting started guide.
diff --git a/README.md b/README.md
index 54c6f04..e61186f 100644
--- a/README.md
+++ b/README.md
@@ -4,26 +4,7 @@
[](https://travis-ci.org/sgrif/diesel)
[Documentation](http://sgrif.github.io/diesel/diesel/index.html)
-This is an early stage ORM in Rust. I would love early feedback on usage, so we can stabilize the API.
-
-The goal is to take a different approach here. This is not a port of Active
-Record or Hibernate. This is an attempt to find what a "Rust ORM" is. So far,
-what that seems to be is something that is statically guaranteed to only allow
-correct queries, while still feeling high level.
-
-An "incorrect query" includes, but is not limited to:
-
-- Invalid SQL syntax
-- Attempting to interpret a column as the wrong type (e.g. reading varchar as
- i32, treating a nullable column as something other than an option)
-- Selecting a column from another table
-- Selecting columns that are not used (this doesn't mean that you have to access
- that field on your struct, but the struct must have that field)
-
-Does it support X?
-------------------
-
-0.1 progress is tracked on https://github.com/sgrif/diesel/issues/1
+Diesel gets rid of the boilerplate for database interaction and eliminates runtime errors, without sacrificing performance. It takes full advantage of Rust's type system to create a low overhead query builder that "feels like Rust".
Getting Started
---------------
diff --git a/diesel/src/lib.rs b/diesel/src/lib.rs
index 2500925..c2338f7 100644
--- a/diesel/src/lib.rs
+++ b/diesel/src/lib.rs
@@ -1,3 +1,6 @@
+//! Diesel is an ORM and query builder designed to reduce the boilerplate for database
+//! interactions. [A getting started guide](https://github.com/sgrif/diesel#getting-started) can be
+//! found in the README.
#![deny(warnings)]
pub mod expression;
#[doc(hidden)]
