#58 Add a troubleshoot section about workflow transitions

docs/eca/troubleshooting.md

@@ -53,3 +53,16 @@ https://www.example.com/admin/config/workflow/eca/process_someid/edit?eca_valida
 
 Then you can make your corrections to the model and save it. From then on, you no longer need that query argument
 anymore.
+
+## Workflow transition sometimes not recognized
+
+When using the workflows module from Drupal core together with content moderation, then the event
+[Workflow: state transition](/plugins/eca/workflow/events/workflow_transition) may not recognize
+the changed state, because the pre-save method in Drupal core may load the wrong revision under certain
+circumstances.
+
+There is a fix in the works for Drupal 11, but it's not yet committed and is unlikely to be back ported to
+Drupal 10 or even 9.
+
+As a workaround, Drupal core can be patched with [this file](https://git.drupalcode.org/project/drupal/-/merge_requests/3599.diff)
+and which is discussed and provided by [this Drupal issue](https://www.drupal.org/project/drupal/issues/3346430).

include/plugins/eca_workflow/event/workflow_transition.md

+!!! warning "Drupal core bug prevents transition recognition under certain circumstances"
+
+    For more details, there is a workaround available which is described in the
+    [Troubleshooting Section](/eca/troubleshooting#workflow-transition-sometimes-not-recognized)

mkdocs.yml

 site_name: ECA - Drupal Events, Conditions, Actions
 site_url: https://ecaguide.org
-site_description: Documentation for Drupal's ECA module and all the implemented modellers like Camunda or BPMN.iO
+site_description: Documentation, tutorials and resources for Drupal's ECA module and its eco-system.
+dev_addr: 127.0.0.1:8000
 theme:
   name: material
   custom_dir: overrides