From 4090adaecc6ba30eeeabf50aee57c22945fa27eb Mon Sep 17 00:00:00 2001
From: Luke Bakken <luke@bakken.io>
Date: Mon, 23 Oct 2017 06:39:07 -0700
Subject: Add migration note concerning multiple headers

---
 doc/src/guide/migrating_from_1.0.asciidoc | 7 +++++++
 1 file changed, 7 insertions(+)

(limited to 'doc/src/guide/migrating_from_1.0.asciidoc')

diff --git a/doc/src/guide/migrating_from_1.0.asciidoc b/doc/src/guide/migrating_from_1.0.asciidoc
index 14be1fc..4f4ea5b 100644
--- a/doc/src/guide/migrating_from_1.0.asciidoc
+++ b/doc/src/guide/migrating_from_1.0.asciidoc
@@ -195,6 +195,13 @@ Cowboy 2.0 now comes with Erlang.mk templates.
   They are no longer allowed. URIs are expected to be in UTF-8 once
   they are percent-decoded.
 
+* Clients that send multiple headers of the same name
+  will have the values of those headers concatenated into a
+  comma-separated list. This is of special importance in the
+  case of the content-type header, as previously only the
+  first value was used in the `content_types_accepted/2` step
+  in REST handlers.
+
 * Etag comparison in REST handlers has been fixed. Some requests may
   now fail when they succeeded in the past.
 
-- 
cgit v1.2.3

