1 files changed, 23 insertions, 0 deletions
diff --git a/guide/loop_handlers.md b/guide/loop_handlers.md
new file mode 100644
index 0000000..67f8ec9
--- /dev/null
+++ b/guide/loop_handlers.md
@@ -0,0 +1,23 @@
+Loop handlers
+=============
+
+Purpose
+-------
+
+Loop handlers are a special kind of HTTP handlers used when the
+response can not be sent right away. The handler enters instead
+a receive loop waiting for the right message before it can send
+a response.
+
+They are most useful when performing long-polling operations or
+when using server-sent events.
+
+Callbacks
+---------
+
+@todo Describe the callbacks.
+
+Usage
+-----
+
+@todo Explain how to use them.