Improve docs

Author: quantuminformation

README.md

@@ -1,16 +1,15 @@
 # Ember-cli-test-recorder
-Recording your steps used to interact with an Ember applications
- to then be added to an integration test. The idea is to save you time writing these
- tests by hand.
+This records the ways you interact with an Ember application, and then generates the code to playback these actions and 
+ test results in an acceptance test. The idea is to save you time writing these tests by hand.
 
 You should only add this component to your app when your app behaves as
-expected as the mutations will be recorded.
+expected (happy flow) as then you will have the tests generated for expected behaviour
 
 ###Current UI interactions that are recorded for acceptance tests:
 
 * Button clicks, they also generate andThen code blocks. 
 * Record any changes to route
-* Changes in whether items are present in the DOM, only items with ID's are recorded
+* Changes in DOM additions/removals, only items with ID's are recorded and that don't have the doNotRecord css class.
 
 ##Usage
 
@@ -20,10 +19,9 @@ inside the application.hbs template
 ```hbs
 {{test-recorder currentRouteName=currentRouteName}}
 ```
-If you want a particular node to be tested for being in the active dom then give it an id
-eg an element of `<p></p>` will not be recorded, but `<p id='foo'></p>` will have a test generated like:
+All elements that match this selector `[id^=ember]:not(.dont),[data-ember-action]` are recorded. 
+If an element doesn't have an id then a dom path selector will be generated to click on this buttonin a test, ie
 ```js
-
 click("html>body>div>div:eq(0)>button");
 andThen(function () {
  equal(find("#foo").length, 0, "foo removed AFTER user [INSERT REASON]");
@@ -36,10 +34,7 @@ If you don't want an element to be recorded, and any of its children add this cl
 
 Avoid making multiple button clicks (or other interactions that cause asynchronous) updates until DOM has 
 finished updating. This will allow code generated by the mutations observer to be placed in the in the
-generated code.
-
-There are currently some hacks as this is designed not to be embedded into your application,
-ie require code modification.
+generated code. This happens outside of the ember run loop.ImpIm
 
 
 ## Roadmap