README.md in acts_as_api-1.0.0

- old
+ new

@@ -8,11 +8,11 @@
 
 `rake spec:#{orm_name}` will run the spec suite for a specific ORM.
 
 ## Working with the specs
 
-acts_as_api can be used with lots of different configurations, depending e.g. on the ORM (ActiveRecord, Mongoid, vanilla ruby) or the way the content is rendered (usual Rails controller, vs. Responder).
+acts_as_api can be used with lots of different configurations, depending e.g. on the ORM (ActiveRecord, Mongoid, vanilla ruby) or the way the content is rendered (usual Rails controller vs. Responder).
 
 A goal of the lib is to stay consistent in its behaviour over these different configurations, so it won't get in your way, once you change other parts of your application.
 
 To achieve this goal and because of the need to keep the specs as DRY as possible, the following spec setup was created:
 
@@ -26,19 +26,29 @@
 
 There used to be one Rails app that contained all supported ORMs. But multiple times this setup veiled problems e.g. with ORM-specific dependencies.
 
 Now there are multiple Rails apps, one for every supported ORM: `./active_record_dummy` and `./mongoid_dummy`.
 
-These are very simple apps, basically just clicked together on [railswizard.org](http://railswizard.org).
+These are very simple apps, they contain **no controllers** to be tested, just models that match the tested ones.
 
-They contain **no controllers** to be tested, just models that match the tested ones.
+### Debugging in the dummy apps
 
-### Adding a dummy Rails app
+Even though they are simple, you can still use the `rails console` of the dummy apps to debug acts_as_api.
 
+```
+$ cd spec/active_record_dummy
+$ rails c
+irb> User.last.as_api_response(:name_only)
+```
+
+This can come in very handy sometimes.
+
+### Adding a new dummy Rails app (in case you want to add another ORM)
+
 * Create a new Rails app in the folder `./spec/#{orm_name}_dummy`.
 
-* Create to Models used in the spec (`User, Profile, Untouched, Task`).
+* Create the models used in the spec (`User, Profile, Untouched, Task`).
 
 * Include `UserTemplate` in your `User` model.
 
 * Add `mount SharedEngine::Engine => "/shared", :as => "shared"` to your `routes.rb`
 
@@ -48,8 +58,7 @@
 gem 'shared_engine', :path => '../shared_engine'
 gem 'acts_as_api', :path => '../../'
 ```
 
 * Add your dummy app to the `Rakefile` in the root folder by adding it to the `supported_orms` array.
-
 
 If you have to do some special setup (e.g. creating a schema) you can do this in `./spec_helper.rb`.