diff --git a/CHANGELOG.md b/CHANGELOG.md index 8ea558a4..14a633a5 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,6 +1,9 @@ Latest ------ +## Changes +* [#90](https://github.com/cleverage/process-bundle/issues/90) Installation documentation: describe the Symfony Flex recipe ([symfony/recipes-contrib#2081](https://github.com/symfony/recipes-contrib/pull/2081)), which registers the bundle and creates `config/packages/clever_age_process.yaml` importing the `config/packages/process/` directory, and the manual setup without Flex. + v5.4 ----- diff --git a/docs/01-quick_start.md b/docs/01-quick_start.md index 1b62da0c..67bf7be8 100644 --- a/docs/01-quick_start.md +++ b/docs/01-quick_start.md @@ -30,12 +30,30 @@ Open a command console, enter your project directory and install it using compos composer require cleverage/process-bundle ``` -Remember to add the following line to `config/bundles.php` (not required if Symfony Flex is used): +With [Symfony Flex](https://symfony.com/doc/current/setup/flex.html), the +[recipe](https://github.com/symfony/recipes-contrib/tree/main/cleverage/process-bundle) registers the bundle and creates: +- `config/packages/clever_age_process.yaml`: the [global configuration](#global-configuration), which imports the + `config/packages/process/` directory, +- `config/packages/process/`: the directory of your processes, one file per process (see + [process definition](reference/01-process_definition.md)). + +Without Flex, add the following line to `config/bundles.php`: ```php CleverAge\ProcessBundle\CleverAgeProcessBundle::class => ['all' => true], ``` +Then create the `config/packages/process/` directory and the configuration that imports it: + +```yaml +# config/packages/clever_age_process.yaml +imports: + - { resource: process/ } + +clever_age_process: + default_error_strategy: stop +``` + Some tasks and transformers use the Symfony serializer (`NormalizerTask`, `DenormalizerTask`, `SerializerTask`, `DeserializerTask`, the `normalize` and `denormalize` transformers) or validator (`ValidatorTask`) services. If they are not enabled, the container still compiles, and a process using one of these tasks or transformers fails with an explicit