README.rdoc in arbre-0.0.1 vs README.rdoc in arbre-1.0.0.rc1

@@ -1,3 +1,69 @@
-Arbre - Coming Soon. For now, checkout Active Admin:
+= Arbre - Ruby Object Oriented HTML Views
 
-http://github.com/gregbell/active_admin
+Arbre is the DOM implemented in Ruby. This project is primarily used as
+the object oriented view layer in Active Admin.
+
+== Simple Usage
+
+A simple example of setting up an Arbre context and creating some html
+
+    html = Arbre::Context.new do
+      h2 "Why Arbre is awesome?"
+
+      ul do
+        li "The DOM is implemented in ruby"
+        li "You can create object oriented views"
+        li "Templates suck"
+      end
+    end
+
+    puts html.to_s #=> <h2>Why</h2><ul><li></li></ul>
+
+
+== The DOM in Ruby
+
+The purpose of Arbre is to leave the view as ruby objects as long
+as possible. This allows OO Design to be used to implement the view layer.
+
+
+    html = Arbre::Context.new do
+      h2 "Why Arbre is awesome?"
+    end
+
+    html.children.size #=> 1
+    html.children.first #=> #<Arbre::HTML::H2>
+
+== Components
+
+The purpose of Arbre is to be able to create shareable and extendable HTML
+components. To do this, you create a subclass of Arbre::Component.
+
+For example:
+
+    class Panel < Arbre::Component
+      builder_method :panel
+
+      def build(title, attributes = {})
+        super(attributes)
+
+        h3(title, :class => "panel-title")
+      end
+    end
+
+The builder_method defines the method that will be called to build this component
+when using the DSL. The arguments passed into the builder_method will be passed 
+into the #build method for you.
+
+You can now use this panel in any Arbre context:
+
+    html = Arbre::Context.new do
+      panel "Hello World", :id => "my-panel" do
+        span "Inside the panel"
+      end
+    end
+
+    html.to_s #=>
+      # <div class='panel' id="my-panel">
+      #   <h3 class='panel-title'>Hello World</h3>
+      #   <span>Inside the panel</span>
+      # </div>