README.md in standup-0.3.5 vs README.md in standup-0.3.6

@@ -9,29 +9,73 @@
 0. `standup init`
 0. Fill in actual settings in generated file `config/standup.yml`
 0. `standup setup`
 0. `standup status`
 
-## Tweaking default scripts
+## Config file
 
+It consists of 3 major parts:
+
+### Amazon Web Services credentials
+
+    aws:
+      account_id: 0123-4567-8910
+      access_key_id: GTFGV123P45DRDKOBBVP
+      secret_access_key: jKkjhkjbb1Bhjh+MBG0GBbmuhdGh/Kgbdhzbd9sd
+      keypair_name: aws
+      availability_zone: us-east-1c
+
+Here, keypair_name is keypair filename, without `.pem` extension.
+By default, Standup searches actual file under `~/.ssh` directory.
+You can override this behavior by specifying `keypair_file` param.
+
+### Global script params
+
+    ec2:
+      image_id: ami-480df921 # Canonical Ubuntu 10.04, EBS boot
+      instance_type: m1.small
+      ssh_user: ubuntu
+    webapp:
+      github_user: supercoder
+      github_repo: superproject
+
+Major part of script params can be set here.
+
+### Nodes and their script params
+
+    nodes:
+      main:
+        ec2:
+          elastic_ip: 123.123.123.123
+      testing:
+      staging:
+
+Here, under `nodes` section, should go actual nodes (server instances) which you want to manage.
+For each node, you can specify additional script params.
+In this example, `elastic_ip` param of `ec2` script is set for node `main`.
+
+Script params are merged in `node-specific || global || script-defaults` manner.
+
+## Tweaking bundled scripts
+
 0. `standup localize <script_name>`
 0. Script file `config/standup/<script_name>.rb` will be copied from gem.
-0. Script's own files, like configs etc. under `config/standup/<script_name>`, if any,  will be copied from gem too. 
+0. Script's own files, like configs etc. under `config/standup/<script_name>`, if any, will be copied from gem too. 
 0. You can edit them and standup will use them instead of default.
 0. You can delete local script's own files, then default ones will be used. 
 
 ## Creating new scripts
 
 0. `standup generate <script_name>`
 0. Script file `config/standup/<script_name>.rb` will be created with empty script stub.
-0. Edit it as you want, it's now available for standup.
+0. Edit it as you want, it's now available for Standup.
 
 ## Setup script
 
-Setup script is just common Rails application deployment workflow.
+Setup script automates common Rails application deployment workflow.
 
-If you just want to add your script into this workflow, just set it as script param, thus overwriting default.
+If you want to add your script into this workflow, just set it as script param, thus overwriting default.
 
 For example, if you want to add `rescue` to your configuration, you need to:
 
 0. Write that `rescue` script
 0. Change standup.yml like the following:
@@ -41,11 +85,9 @@
             ...
             setup:
               ec2 basics ruby postgresql passenger rescue webapp update 
 
 ## To do
-
-- `standup -v`
 
 - **?** Script sequences: rework default script as script sequence
 
 - ERB processing for script files