Issue #2851603 by Sam152: Add inline documentation to content moderation...

Issue #2851603 by Sam152: Add inline documentation to content moderation onDependencyRemoval() that describes what's happening

core/modules/workflows/src/Entity/Workflow.php

@@ -166,10 +166,11 @@ public function status() {
    * {@inheritdoc}
    */
   public function onDependencyRemoval(array $dependencies) {
-    $changed = $this->getTypePlugin()->onDependencyRemoval($dependencies);
-    // Ensure the parent method is called in order to process dependencies that
-    // affect third party settings.
-    return parent::onDependencyRemoval($dependencies) || $changed;
+    // Give the parent method and the workflow type plugin a chance to react
+    // to removed dependencies and report if either of these two made a change.
+    $parent_changed_entity = parent::onDependencyRemoval($dependencies);
+    $plugin_changed_entity = $this->getTypePlugin()->onDependencyRemoval($dependencies);
+    return $plugin_changed_entity || $parent_changed_entity;
   }
 
 }