README.md in qor_dsl-0.0.5 vs README.md in qor_dsl-0.1.0

@@ -1,4 +1,80 @@
-qor_dsl
+Qor Dsl - DSL made easy!
 =======
 
-Qor DSL
\ No newline at end of file
+## Description
+
+    Why DSL? Easy to read, Easy to write, Easy to maintain!
+    Why Qor DSL? Make it even easier! Write your DSLs in 10 minutes!
+
+## Usage
+
+1, Adding it as dependency to your Gemspec or Gemfile:
+
+    # your_awesome_gem.gemspec
+    Gem::Specification.new do |gem|
+      gem.add_dependency "qor_dsl"
+    end
+
+    # Gemfile
+    gem "qor_dsl"
+
+2, Defining DSL (Sample configuration support DSLs like [Gemfile](http://gembundler.com))
+
+    # gemfile.rb
+    class Gemfile
+      include Qor::Dsl
+      default_configs [ENV['BUNDLE_GEMFILE'], 'Gemfile']
+
+      node :source
+      node :gem
+
+      node :group do
+        node :gem
+      end
+    end
+
+3, Defining config (Sample Gemfile file used for above config)
+
+    # Gemfile
+    source 'http://rubygems.org'
+
+    gem 'rails', '3.2.8'
+    gem 'unicorn'
+    gem 'devise', :git => "git://github.com/jinzhu/devise.git", :ref => "b94ee9da98b16e4c8fbdc91af8605669d01b17e6"
+
+    group :development do
+      gem 'pry-rails'
+    end
+
+    group :test do
+      gem 'rspec'
+    end
+
+4, Querying config (Please checkout the source code and play with examples under the /example directory for more details)
+
+    # Find by type
+    Gemfile.find(:gem)
+
+    # Find by type and name also chain query
+    Gemfile.find(:group, 'development').find(:gem)
+
+    # Get all gems
+    Gemfile.deep_find(:gem)
+
+    # Find by block
+    Gemfile.deep_find(:gem) do |n|
+      # Find all gems used in development environment
+      parent = n.parent
+      parent.root? || ((parent.config_name == :group) && parent.name == :development)
+    end
+
+    # Qor DSL is designed to be as flexible as possible while helping you to create your DSLs.
+    # Please check source code for all possibilities!
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request