From 394b4f0bf7f2a4d496ffe69c8e30cff153d69532 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Hoguin?= <essen@ninenines.eu>
Date: Thu, 14 Jan 2016 20:00:50 +0100
Subject: Simplify example instructions and fix broken examples

Also convert to AsciiDoc while we're at it.
---
 examples/rest_stream_response/README.asciidoc | 67 +++++++++++++++++++++++++++
 1 file changed, 67 insertions(+)
 create mode 100644 examples/rest_stream_response/README.asciidoc

(limited to 'examples/rest_stream_response/README.asciidoc')

diff --git a/examples/rest_stream_response/README.asciidoc b/examples/rest_stream_response/README.asciidoc
new file mode 100644
index 0000000..411c4c4
--- /dev/null
+++ b/examples/rest_stream_response/README.asciidoc
@@ -0,0 +1,67 @@
+= REST streaming example
+
+To try this example, you need GNU `make` and `git` in your PATH.
+
+To build and run the example, use the following command:
+
+[source,bash]
+$ make run
+
+Then point your browser to http://localhost:8080
+
+== About
+
+This example simulates streaming a large amount of data from a data store one
+record at a time in CSV format. It also uses a constraint to ensure that the
+last segment of the route is an integer.
+
+== Example output
+
+Fetch records with the second field with value 1:
+
+[source,bash]
+----
+$ curl -i localhost:8080
+HTTP/1.1 200 OK
+transfer-encoding: identity
+server: Cowboy
+date: Sun, 10 Feb 2013 19:32:16 GMT
+connection: close
+content-type: text/csv
+
+DBUZGQ0C,1,28
+BgoQAxMV,1,6
+DAYEFxER,1,18
+...
+----
+
+Fetch records with the second field with value 4:
+
+[source,bash]
+----
+$ curl -i localhost:8080/4
+HTTP/1.1 200 OK
+transfer-encoding: identity
+server: Cowboy
+date: Sun, 10 Feb 2013 19:34:31 GMT
+connection: close
+content-type: text/csv
+
+ABcFDxcE,4,42
+DgYQCgEE,4,5
+CA8BBhYD,4,10
+...
+----
+
+Fail to use a proper integer and get an error:
+
+[source,bash]
+----
+$ curl -i localhost:8080/foo
+HTTP/1.1 404 Not Found
+connection: keep-alive
+server: Cowboy
+date: Sun, 10 Feb 2013 19:36:16 GMT
+content-length: 0
+
+----
-- 
cgit v1.2.3

