README.rdoc in factorylabs-fdlcap-0.2.4 vs README.rdoc in factorylabs-fdlcap-0.2.5

@@ -1,7 +1,60 @@
 = fdlcap
 
-Description goes here.
+Inspired by Engine Yard's eycap (http://github.com/engineyard/eycap), fdlcap is a set of extracted cap tasks, configurations, and callbacks from various Factory Design Labs projects.
 
+It's designed to ease some common scenarios for deploying reasonably complex apps to Engine Yard environments.  It's also designed to make it easier to package up deployment logic and make it reusable.
+
+Some of the recipes include:
+
+- auto_tagger - provide a default set of stages and set up deploy callbacks for progressive deployment with auto_tagger (http://github.com/zilkey/auto_tagger))
+- craken - set up deploy callbacks for deploying raketab files to cron with craken
+- delayed_job - start/stop/restart delayed_job workers with monit and set up deploy callbacks for restarting workers
+- geminstaller - set up deploy callbacks for running chad woolley's geminstaller
+- newrelic - set up deploy callbacks for notifying newrelic of deployments
+- rake - run arbitrary rake tasks, commands, and ruby snippets on remote servers from a single command
+- rsync - pull assets from production servers to development
+- sass - set up deploy callbacks for updating sass stylesheets on deploy to avoid caching issues
+- slice - tail arbitrary server logs and show custom maintenance pages
+- ssh - shortcut to execute ssh sessions and tunnels to remote servers
+- thinking_sphinx - set up deploy callbacks for thinking sphinx
+
+One kind of cool addition is a simple mechanism for bundling callbacks, configuration variables, and tasks into reusable recipe chunks that can easily be dropped into your deploy configuration.
+
+For example, to automatically set up tasks and callbacks for delayed_job and sass, you would add the following to deploy.rb:
+
+  use_recipe :delayed_job
+  use_recipe :sass
+
+You can also create your own recipe chunks with the define_recipe method:
+
+  define_recipe :my_recipe do
+    # tasks, config, whatever go here
+  end
+
+Then include them in your deploy.rb:
+
+  use_recipe :my_recipe
+
+==Prereqs
+
+Aside from capistrano, fdlcap depends on the following gems:
+
+- capistrano-ext (for multistage deployments)
+- engineyard-eycap (for deployment configurations and support recipes - http://github.com/engineyard/eycap)
+- zilkey-auto_tagger (for rolling deploy tags via git - http://github.com/zilkey/auto_tagger)
+
+These should all be installed automatically by rubygems when you install fdlcap.  
+
+==Installation
+
+  sudo gem install factorylabs-fdlcap --source=http://gems.github.com
+
+You may want to add the gem to your config.gems or geminstaller config as well.
+
+You'll also need to add the following line to your deploy.rb:
+
+  require 'fdlcap/recipes'
+
 == Copyright
 
-Copyright (c) 2009 Gabe Varela. See LICENSE for details.
+Copyright (c) 2009 Gabe Varela and Jay Zeschin. See LICENSE for details.