Make it easier to get started

Created on 15 May 2024, 6 months ago

Problem/Motivation

I very much appreciate this project, so thanks for making it. But it's too difficult to get started with. Both for those who just want to give it a try, but also for people who seriously want to use it. If you visit the official documentation page at https://ecaguide.org/ and go through the pages "Installation" and "Usage" pages, you probably hit a dead end, as a new user ...

Steps to reproduce

Want to try ECA and fail get it up and running, by having too many options, and different parts, and not a few simple straightforward steps to reach success.

Also, while having multiple modellers gives flexibility, it is another source of confusion. Instead of giving the user these two simple commands, which would get new user up an running, the user is left in limbo, trying to figure out how it all is glued together:

composer require drupal/eca drupal/bpmn_io
drush in eca bpmn_io

Proposed resolution

  1. Document the fewest steps necessary to get set up, and build a simple rule
  2. Choose a single model (BPMN.iO?) and use that everywhere

Remaining tasks

  1. Write and add this documentation. Alternatively, place a link to an article such as Creating Drupal processes with the event condition action module prominently, to make sure new users sees this, and get a good impression of ECA, successfully executing an ECA rule.
  2. Decide if the BPMN.iO modeller should be singled out as the default. The two alternatives can of course still be mentioned, but be positioned less prominently.

User interface changes

API changes

Data model changes

📌 Task
Status

Closed: duplicate

Version

2.0

Component

Documentation

Created by

🇩🇰Denmark ressa Copenhagen

Live updates comments and jobs are added and updated live.
Sign in to follow issues

Comments & Activities

Production build 0.71.5 2024