Follow-up to #2416409: Delete dependent config entities that don't implement onDependencyRemoval() when a config entity is deleted
+++ b/core/lib/Drupal/Core/Config/Entity/ConfigEntityInterface.php
@@ -176,7 +172,11 @@ public function calculateDependencies();
* @return bool
* TRUE if the entity has changed, FALSE if not.
*
+ * @return bool
+ * TRUE if the entity has been changed as a result, FALSE if not.
+ *It's good to add comments, but is the return value double documented?