docs: move the crate-level docs to top of the lib.rs file

src/lib.rs

@@ -1,12 +1,3 @@
-#![crate_type= "lib"]
-#![cfg_attr(feature = "nightly", feature(plugin))]
-//#![cfg_attr(feature = "lints", plugin(clippy))]
-//#![cfg_attr(feature = "lints", allow(option_unwrap_used))]
-//#![cfg_attr(feature = "lints", allow(explicit_iter_loop))]
-//#![cfg_attr(feature = "lints", deny(warnings))]
-// Fix until clippy on crates.io is updated to include needless_lifetimes lint
-//#![cfg_attr(feature = "lints", allow(unknown_lints))]
-
 //! Command Line Argument Parser for Rust
 //!
 //! It is a simple to use, efficient, and full featured library for parsing command line arguments
@@ -475,7 +466,16 @@
 //! `clap` is licensed under the MIT license. Please read the [LICENSE-MIT](https://raw.githubusercontent.com/kbknapp/clap-rs/master/LICENSE-MIT)
 //! file in
 //! this repository for more information.
-//!
+
+#![crate_type= "lib"]
+#![cfg_attr(feature = "nightly", feature(plugin))]
+//#![cfg_attr(feature = "lints", plugin(clippy))]
+//#![cfg_attr(feature = "lints", allow(option_unwrap_used))]
+//#![cfg_attr(feature = "lints", allow(explicit_iter_loop))]
+//#![cfg_attr(feature = "lints", deny(warnings))]
+// Fix until clippy on crates.io is updated to include needless_lifetimes lint
+//#![cfg_attr(feature = "lints", allow(unknown_lints))]
+
 
 #[cfg(feature = "suggestions")]
 extern crate strsim;