From 4875dc703d0efa905b1390aeb817b4e2943a66e9 Mon Sep 17 00:00:00 2001
From: Robert Jackson <robert.w.jackson@me.com>
Date: Sun, 10 Apr 2016 21:50:48 -0400
Subject: [PATCH] Add `{{#render` block deprecation.

---
 source/deprecations/v2.x.html.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/source/deprecations/v2.x.html.md b/source/deprecations/v2.x.html.md
index cd921b6d07..63e7fa1d94 100644
--- a/source/deprecations/v2.x.html.md
+++ b/source/deprecations/v2.x.html.md
@@ -314,6 +314,29 @@ export default Ember.Helper.extend({
 });
 ```
 
+### Deprecations Added in 2.4
+
+#### {{#render}} helper with block
+
+The `{{render}}` helper was never intended to support a block form, but unfortunatley (mostly
+due to various refactorings in 1.10 and 1.13) it started working in block form. Since this was
+not properly engineered, there are a number of caveats (i.e. the `controller` and `target` values of
+anything inside the block are incorrect) that prevent continued support.
+
+Support the following forms will be removed after 2.4:
+
+```hbs
+{{#render 'foo'}}
+  <p>Stuff Here</p>
+{{/render}}
+```
+
+```hbs
+{{#render 'foo' someModel}}
+  <p>Stuff Here</p>
+{{/render}}
+```
+
 ### Deprecations Added in 2.6
 
 #### Use Ember.String.htmlSafe over Ember.Handlebars.SafeString