diff --git a/docs/integrations/ember-and-json-api.md b/docs/integrations/ember-and-json-api.md
index 57454b72..eb7f1ade 100644
--- a/docs/integrations/ember-and-json-api.md
+++ b/docs/integrations/ember-and-json-api.md
@@ -74,6 +74,9 @@ Then, in your controller you can tell rails you're accepting and rendering the j
 end
 ```
 
+#### Note: 
+In Rails 5, the "unsafe" method ( `jsonapi_parse!` vs the safe `jsonapi_parse`) throws an `InvalidDocument` exception when the payload does not meet basic criteria for JSON API deserialization.
+
 
 ### Adapter Changes