README.md in simple_states-0.0.2 vs README.md in simple_states-0.0.4

@@ -1,6 +1,6 @@
-# simple\_states
+# simple\_states [![Build Status](https://secure.travis-ci.org/svenfuchs/simple_states.png)](http://travis-ci.org/svenfuchs/simple_states)
 
 A super-slim (~200 loc) statemachine-like support library focussed on use in
 Travis CI.
 
 ## Usage
@@ -13,15 +13,23 @@
       states :created, :started, :finished
 
       event :start,  :from => :created, :to => :started,  :if => :startable?
       event :finish, :to => :finished, :after => :cleanup
 
-      attr_accessor :state
+      attr_accessor :state, :started_at, :finished_at
 
       def start
         # start foo
       end
+
+      def startable?
+        true
+      end
+
+      def cleanup
+        # cleanup foo
+      end
     end
 
 Including the SimpleStates module to your class is currently required. We'll add
 hooks for ActiveRecord etc later.
 
@@ -64,5 +72,37 @@
 
 If no target state was given for an event then SimpleStates will try to derive
 it from the states list. I.e. for an event `start` it will check the states
 list for a state `started` and use it. If it can not find a target state this
 way then it will raise an exception.
+
+By default SimpleStates will assum `:created` as an initial state. You can
+overwrite this using:
+
+    self.initial_state :something
+
+So with the example above something the following would work:
+
+    foo = Foo.new
+
+    foo.state            # :created
+    foo.created?         # true
+    foo.was_created?     # true
+    foo.state?(:created) # true
+
+    foo.start            # checks Foo#startable? and then calls Foo#start
+
+    foo.state            # :started
+    foo.started?         # true
+    foo.started_at       # Time.now
+    foo.created?         # false
+    foo.was_created?     # true
+
+    foo.finish           # just performs state logic as there's no Foo#finish
+
+    foo.state            # :finished
+    foo.finished?        # true
+    foo.finished_at      # Time.now
+    foo.was_created?     # true
+    foo.was_started?     # true
+
+