From d4c0b10cb91ffd080d5adb66d5b1c700feff91d7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Felix=20Geisendo=CC=88rfer?= <felix@debuggable.com>
Date: Sun, 17 Mar 2013 11:45:36 +0100
Subject: [PATCH] More docs

---
 README.md | 17 ++++++++++++-----
 1 file changed, 12 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index dc4f638..bf7e56b 100644
--- a/README.md
+++ b/README.md
@@ -33,7 +33,11 @@ Prior art:
 
 ### POST /files
 
-**Request**
+Used to create a resumable file upload. You may send parts or all of your file
+along with this request, but this is discouraged as you will not be able to
+resume the request if something goes wrong.
+
+**Request Example:**
 
 ```
 POST /files HTTP/1.1
@@ -42,8 +46,11 @@ Content-Length: 0
 Content-Range: bytes */100
 Content-Type: image/jpg
 ```
+```
+<empty body>
+```
 
-**Response:**
+**Response Example:**
 
 ```
 HTTP/1.1 201 Created
@@ -53,7 +60,7 @@ Content-Length: 0
 
 ### PUT /files/\<id\>
 
-**Request:**
+**Request Example:**
 ```
 PUT /files/123d3ebc995732b2 HTTP/1.1
 Host: tus.example.com
@@ -61,10 +68,10 @@ Content-Length: 100
 Content-Range: bytes 0-99/100
 ```
 ```
-[bytes 0-99]
+<bytes 0-99>
 ```
 
-**Response:**
+**Response Example:**
 ```
 HTTP/1.1 200 Ok
 ```