Skip to content

Commit a112e5f

Browse files
docs: describe feature task ordering and feature:select
1 parent 45ca61f commit a112e5f

1 file changed

Lines changed: 3 additions & 5 deletions

File tree

docs/FEATURE.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -55,11 +55,7 @@ The `feature:setup` command represent the initialization of a new feature branch
5555
$ vendor/bin/dep feature:setup stage --feature=TEST-01
5656
```
5757

58-
This task should be declared to run at first within your deploy task:
59-
60-
```php
61-
before('deploy:info', 'feature:setup');
62-
```
58+
The recipe already wires this task into the deploy flow, together with a `feature:init` before `deploy:info`. That ordering matters: `deploy:info` resolves `{{release_name}}` and deployer caches the result for the rest of the run, so the feature instance has to be known before it runs. Do not hook `feature:setup` any earlier yourself.
6359

6460
If the application needs to setup additional configuration files for e.g. storing the database credentials, use the feature templates to provide this kind of dynamic setup. For example the TYPO3 setup with a `.env` file:
6561

@@ -88,6 +84,8 @@ You can extend these list be providing more environment variables starting with
8884
> ```php
8985
> before('deploy:rollback', 'feature:init');
9086
> ```
87+
>
88+
> `feature:init` is a no-op without `--feature`, so the command keeps operating on the base instance. Use `feature:select` instead if the command should offer an interactive choice between the existing feature instances when `--feature` is omitted.
9189
9290
### Deletion
9391

0 commit comments

Comments
 (0)