Merge pull request #2525 from willrax/deprecate-didinitattrs

add documentation for didinitattrs deprecation

source/deprecations/v2.x.html.md

@@ -342,3 +342,36 @@ export default Ember.Component.extend({
   });
 )};
 ```
+
+#### Ember.Component#didInitAttrs
+
+Using `didInitAttrs` is deprecated in favour of using `init`. When `init` is called the attrs sent in with the component will be
+available after calling `this._super(...arguments)`
+
+Given a htmlbars template like this:
+
+```hbs
+{{my-component handle="@tomdale"}}
+```
+
+Before:
+
+```js
+export default Ember.Component.extend({
+  didInitAttrs() {
+    this._super(...arguments);
+    this.get('handle'); // @tomdale
+  }
+});
+```
+
+After:
+
+```js
+export default Ember.Component.extend({
+  init() {
+    this._super(...arguments);
+    this.get('handle'); // @tomdale
+  }
+});
+```