README.md in sunzi-rails-0.2.16 vs README.md in sunzi-rails-0.2.17

@@ -58,19 +58,21 @@
 
 Finally, add `/compiled` to your `.gitignore` file.
 
 All those settings can be overriden in your `sunzi.yml` file within `attributes`.
 
-Also, deploy.rb, deploy/[stage].rb, database.yml (prefixed with `db_`), secrets.yml and contextual attributes (prefixed with `env_`) are available through `@attributes`:
+Also, `deploy.rb`, `deploy/[stage].rb`, `database.yml` (prefixed with `db_`), `secrets.yml` and contextual attributes (prefixed with `env_`) are available through `@attributes`:
 
 ```ruby
 @attributes.env_stage
 @attributes.env_role
 @attributes.env_sudo
 @attributes.env_user
 @attributes.env_host
 @attributes.env_port
 ```
+
+It's important to note that `deploy.rb` and `deploy/[stage].rb` are loaded in that order and that variables defined within `deploy/[stage].rb` aren't available within `deploy.rb`.
 
 Go into the project directory, then run `sunzi-cap deploy`:
 
 ```bash
 $ sunzi-cap deploy staging admin --sudo