Merge pull request #7659 from celsowm/patch-16

Update saving-data.rst

en/orm/saving-data.rst

@@ -1035,6 +1035,18 @@ by setting data to the ``_joinData`` property::
 
     $studentsTable->save($student);
 
+The example above will only work if the property ``_joinData`` is already a
+reference to a Join Table Entity. If this is not your case you can populate
+using the Table to create the entity::
+
+    $coursesMembershipsTable = $this->getTableLocator()->get('CoursesMemberships');
+    $student->courses[0]->_joinData = $coursesMembershipsTable->newEntity([
+        'grade' => 80.12,
+        'days_attended' => 30
+    ]);
+
+    $studentsTable->save($student);
+
 The ``_joinData`` property can be either an entity, or an array of data if you
 are saving entities built from request data. When saving junction table data
 from request data your POST data should look like::