README.md in shamu-0.0.1 vs README.md in shamu-0.0.2

@@ -8,5 +8,46 @@
 
 Have a whale of a good time adding Service Oriented Architecture to your ruby projects.
 
 (Also check out [shog](http://github.com/phallguy/shog) for better rails logs)
 
+# SOA
+
+# Components
+
+- {Shamu::Attributes}
+- {Shamu::Entities}
+- {Shamu::Services}
+- {Shamu::Security}
+- {Shamu::Sessions}
+- {Shamu::Events}
+- {Shamu::Auditing}
+- {Shamu::Features}
+- {Shamu::Rails}
+
+
+
+# Dependency Injection
+
+....
+[Scorpion](http://github.com/phallguy/scorpion)
+
+# Using with Rails
+
+
+## Active Record
+
+Shamu does not come with a hard dependency on ActiveRecord - it should work with
+any persistence you've chosen to use in your project. It does come with some
+convenience mixins to make it easier to work with AR.
+
+
+- **{Shamu::Entities::ActiveRecord}** adds convenience methods for working with
+  ActiveRecord models as entities.
+
+## Controllers
+
+- {Shamu::Rails::Controller}
+
+# Contributing
+
+See [LABELS](LABELS.md)
\ No newline at end of file