From c609bb619dd2c6ece85cc4d5d008e57672f80c15 Mon Sep 17 00:00:00 2001
From: Rodrigo Rosenfeld Rosas <rr.rosas@gmail.com>
Date: Mon, 9 May 2016 09:55:12 -0300
Subject: [PATCH] Improve AV changelog with regards to default RAW handler

It highlights which kind of incompatibilities this could lead to when rendering plain JS or HTML partials.
---
 actionview/CHANGELOG.md | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

diff --git a/actionview/CHANGELOG.md b/actionview/CHANGELOG.md
index e610f77f1e003..7e271a693a462 100644
--- a/actionview/CHANGELOG.md
+++ b/actionview/CHANGELOG.md
@@ -292,7 +292,24 @@
 *   Change the default template handler from `ERB` to `Raw`.
 
     Files without a template handler in their extension will be rendered using the raw
-    handler instead of ERB.
+    handler instead of ERB. The raw handler does not flag the rendered text as html safe,
+    so if your application rendered plain JS or HTML files before, you'll have to replace:
+
+    ```erb
+    <%= render '/common/analytics.js' %>
+    ```
+
+    with either
+
+    ```erb
+    <%= raw render '/common/analytics.js' %>
+    ```
+
+    or
+
+    ```erb
+    <%= render('/common/analytics.js').html_safe %>
+    ```
 
     *Rafael Mendonça França*