diff --git a/bin/detect b/bin/detect
index dd1877f9788e9c1566590681d6ee251b09c53eb1..9dcdd07cc364f8faaf11f88daff1199b3bd50002 100755
--- a/bin/detect
+++ b/bin/detect
@@ -1,5 +1,16 @@
 #!/usr/bin/env bash
-# bin/detect <build-dir>
+
+# This script serves as the 
+# [**Python Buildpack**](https://github.com/heroku/heroku-buildpack-python) 
+# detector. 
+# 
+# A [buildpack](http://devcenter.heroku.com/articles/buildpacks) is an 
+# adapter between a Python application and Heroku's runtime.
+
+# ## Usage
+# Compiling an app into a slug is simple:
+# 
+#     $ bin/detect <build-dir> <cache-dir>
 
 BUILD_DIR=$1