readme update
diff --git a/README.md b/README.md
index f5fd68d..925154b 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,10 @@
 [![Build Status](https://drone.io/github.com/kevmoo/shelf_proxy/status.png)](https://drone.io/github.com/kevmoo/shelf_proxy/latest)
 
-Shelf handler to proxy requests to another web server.
+[Shelf][shelf] `handler` to proxy requests to another web server.
+
+Useful if you want to send a subset of requests to another HTTP endpoint, for
+instance `pub serve`.
+
+See `example/example_server.dart` for a usage demonstration.
+
+[shelf]: http://pub.dartlang.org/packages/shelf