README.md in capistrano-rails-1.1.2 vs README.md in capistrano-rails-1.1.3

@@ -8,11 +8,11 @@
 Some rails specific options.
 
 ```ruby
 set :rails_env, 'staging'                  # If the environment differs from the stage name
 set :migration_role, 'migrator'            # Defaults to 'db'
-set :conditionally_migrate, true           # Defaults to false
+set :conditionally_migrate, true           # Defaults to false. If true, it's skip migration if files in db/migrate not modified
 set :assets_roles, [:web, :app]            # Defaults to [:web]
 set :assets_prefix, 'prepackaged-assets'   # Defaults to 'assets' this should match config.assets.prefix in your rails config/application.rb
 ```
 
 If you need to touch `public/images`, `public/javascripts` and `public/stylesheets` on each deploy:
@@ -39,11 +39,20 @@
 
     # Capfile
     require 'capistrano/bundler' # Rails needs Bundler, right?
     require 'capistrano/rails/assets'
     require 'capistrano/rails/migrations'
-    
+
 Please note that any `require` should be placed in `Capfile`, not `config/deploy.rb`.
+
+### Symlinks
+
+You'll probably want to symlink Rails shared files and directories like `log`, `tmp` and `public/uploads`.
+Make sure you enable it by setting `linked_dirs` and `linked_files` options:
+
+    # deploy.rb
+    set :linked_dirs, fetch(:linked_dirs, []).push('log', 'tmp/pids', 'tmp/cache', 'tmp/sockets', 'vendor/bundle', 'public/system', 'public/uploads')
+    set :linked_files, fetch(:linked_files, []).push('config/database.yml', 'config/secrets.yml')
 
 ## Contributing
 
 1. Fork it
 2. Create your feature branch (`git checkout -b my-new-feature`)