Doc suggestion for Relationships > Saving section

[dale42]

In the code example used in the Relationships > Saving section:

actions:{
    addComment(comment, author){
      //Create the comment
      const comment = this.store.createRecord('comment',{
        comment: comment,
        author: author
      });
      //Get our post
      const post = this.controller.get('model');
      //Add our comment to our existing post
      post.get('comments').pushObject(comment);
      //Save the child then the parent
      comment.save().then(() => post.save());
    }
  }

"comment" is used both as a function parameter and a constant name. I found this example initially confusing because I was reading quickly the first time through, and I'm a relatively new Ember user.

I was also experiencing the problem in #160 and though I might be missing the belongsTo relationship. I thought perhaps the example might be wrong. An explicit note that the belongsTo relationship isn't required would have been reassuring. :)

Suggestions:

• Change the function parameter to: addComment(commentText, author) or something similar
• Explicitly note in comments that the belongsTo definition is not required

For example:

actions:{
    addComment(commentText, author){
      //Create the comment
      const comment = this.store.createRecord('comment',{
        // Do not need to specify the belongsTo attribute  
        // of post: post, it's added automatically
        comment: commentText,
        author: author
      });
      //Get our post
      const post = this.controller.get('model');
      //Add our comment to our existing post
      post.get('comments').pushObject(comment);
      //Save the child then the parent
      comment.save().then(() => post.save());
    }
  }

[dweremeichik]

@dale42 sorry about the headache, would you consider submitting a PR?