README.markdown in shield-0.0.0 vs README.markdown in shield-0.0.1

@@ -1,5 +1,36 @@
 # Shield
 
-See the [one file tutorial][tut] for info on getting started.
+Shield
 
-[tut]: http://cyx.github.com/shield
+_n. A solid piece of metal code used to protect your application._
+
+## Why another authentication library?
+
+1. Because most of the other libraries are too huge.
+2. Extending other libraries is a pain.
+3. Writing code is fun :-)
+
+## Description of Shield
+
+1. Simple
+2. Doesn't get in the way
+3. Extensible (see [shield-contrib][shield-contrib]).
+
+## Getting started
+
+The fastest way to get started is by using one of the drop-in solutions
+in [shield-contrib][shield-contrib].
+
+## Tutorials
+
+You can learn more by reading through some of our tutorials:
+
+1. [Sinatra & OHM][sin-ohm]
+2. [Sinatra & Sequel][sin-sequel]
+
+
+[sin]: http://sinatrarb.com
+[ohm]: http://ohm.keyvalue.org
+[shield-contrib]: http://github.com/cyx/shield-contrib
+[sin-ohm]: http://cyx.github.com/shield/sinatra-ohm.html
+[sin-sequel]: http://cyx.github.com/shield/sinatra-sequel.html
\ No newline at end of file