README.md in bently-1.0.0 vs README.md in bently-1.0.1

@@ -2,13 +2,13 @@
 
 Bently is a community maintained library of executable recipes for rapid application development. The bulk of recipes are for automating installation and configuration of commonly-used dependencies. Another potential use case is feature scaffolding, or laying down basic implementation for common functionality like social authentication.
 
 The goal of Bently is to reduce duplication in the development process across projects, with rapid prototyping in mind.
 
-Bently is Homebrew meets Rails generators.
+Bently is [Homebrew](https://github.com/mxcl/homebrew) meets Rails generators.
 
-Bently is built on top of Thor.
+Bently is built on top of [Thor](https://github.com/wycats/thor).
 
 
 Installation
 ============
 
@@ -17,22 +17,25 @@
 
 Usage
 =====
 
     bently list                   # list all recipes
-    bently list [STRING]          # search recipes matching a string
+    bently list [STRING]          # find recipes matching a string
     bently read [RECIPE]          # display a recipe without executing it
     bently bake [RECIPE]          # execute all steps in recipe
     bently bake [RECIPE] --step   # execute a recipe step by step, prompting before each step
     bently source [RECIPE]        # output the URL for the document on which the recipe is based
 
 
 Example
 =======
 
-Installing and configuring devise in a Rails application.
+Installing and configuring devise in a Rails application
 
     $ bently bake devise
+    
+which executes and outputs
+
         gemfile  devise
               1  
               2  gem "devise"
             run  bundle install from "."
             run  rails generate devise:install from "."