diff --git a/docs/httpbin.1.md b/docs/httpbin.1.md
index fd2e0c9..a251d74 100644
--- a/docs/httpbin.1.md
+++ b/docs/httpbin.1.md
@@ -3,17 +3,34 @@ httpbin(1): HTTP Client Testing Service
 
 ## SYNOPSIS
 
+`/` This page.  
+`/user-agent` Returns user-agent string.  
+`/headers` Returns header dict.  
+`/get` Returns GET data.  
+`/post` Returns POST data.  
+`/put` Returns PUT data.  
+`/delete` Returns DELETE data.  
+
 
 ## DESCRIPTION
 
-## CONFIGURATION
+Testing an HTTP Library can become difficult sometimes. PostBin is fantastic
+for testing POST requests, but not much else. This will cover everything.
+
+Plans at the moment are to return JSON for all responses. Request storage
+/ aggregation may or may not exist. We'll see.
 
 
 ## EXAMPLES
 
-## AUTHORS
+    $ curl http://httpbin.com/user-agent
+
+
+## AUTHOR
+
+A [Kenneth Reitz](http://kennethreitz.com/pages/open-projects.html)
+Project.
 
 ## SEE ALSO
 
-
-
+<http://python-requests.org>, <http://postbin.org>, <https://github.com/tml/postbin>