diff --git a/README.md b/README.md
index 553ebb2..9f9ed00 100644
--- a/README.md
+++ b/README.md
@@ -2,9 +2,15 @@
 
 Collection of cool tools that make life easier.
 
-## Scripts
+## The tools
 
-- [release.sh](https://github.com/superhelio/tools/blob/master/release.sh) - Git Flow release flow with automatic version bumping
+- [release.sh](release.sh) - [Git Flow](http://nvie.com/posts/a-successful-git-branching-model/) release flow with automatic version bumping and changelog updating.
+    - **Requires:** `bash`, `git` and `sed`
+    - **Features:**
+        - Helps you [keep your CHANGELOG.md up to date](http://keepachangelog.com/): Lists your commit messages, gives you a change to modify results before committing.
+        - Supports GitHub and Bitbucket tag comparison urls
+    - **Usage:**
+        - Commit everything, run `release.sh` and follow directions
 
 ## Changelog