Merge branch 'develop' into 'main'

Develop

Closes #58

See merge request !87

docker-compose.yml

@@ -3,13 +3,13 @@ version: '3.7'
 services:
   mkdocs:
     container_name: mkdocs
-    image: polinux/mkdocs:1.4.2
+    image: registry.lakedrops.com/docker/mkdocs:1.5.2.1
     restart: unless-stopped
     ports:
       - 8999:8000
     environment:
       LIVE_RELOAD_SUPPORT: 'true'
-      ADD_MODULES: fontawesome-markdown mkdocs-git-revision-date-localized-plugin mkdocs-material==9.2.3 mkdocs-build-plantuml-plugin mkdocs-new-features-notifier mkdocs-git-authors-plugin markdown-include mkdocs-simple-hooks mkdocs-video tzdata
+      ADD_MODULES: fontawesome-markdown mkdocs-git-revision-date-localized-plugin mkdocs-material==9.2.8 mkdocs-build-plantuml-plugin mkdocs-new-features-notifier mkdocs-git-authors-plugin markdown-include mkdocs-simple-hooks mkdocs-video tzdata
       FAST_MODE: 'true'
       DOCS_DIRECTORY: /mkdocs
     volumes:

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