Skip to content

Commit 01b2812

Browse files
Copilotmazhelez
andcommitted
Update documentation to reflect custom job behavior changes
Co-authored-by: mazhelez <[email protected]>
1 parent 7e72f93 commit 01b2812

File tree

2 files changed

+8
-1
lines changed

2 files changed

+8
-1
lines changed

Scenarios/UpdateAlGoSystemFiles.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,10 @@
2424

2525
1. By default, this workflow will apply any updates to the **workflow files (in .github\\workflows)** or **system scripts (in .AL-Go)** from the template repository used to spin up the repository. If you want to change branch or template Url, you can specify the `templateUrl@branch` when you run the workflow.
2626

27+
1. **Custom jobs behavior**: When updating system files, custom jobs are handled differently based on repository type:
28+
- **Template repositories** (without `templateUrl` setting): Custom jobs are preserved and applied
29+
- **Final repositories** (with `templateUrl` pointing to another repository): Custom jobs from the current repository are NOT applied to prevent persistence of jobs removed from the template
30+
2731
______________________________________________________________________
2832

2933
[back](../README.md)

Scenarios/settings.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -408,7 +408,10 @@ In the `needs` property, you specify which jobs should be complete before this j
408408
strategy: ${{ fromJson(needs.Initialization.outputs.environmentsMatrixJson) }}
409409
```
410410

411-
Custom jobs will be preserved when running Update AL-Go System Files.
411+
Custom jobs will be preserved when running Update AL-Go System Files, with the following behavior:
412+
413+
- **Template repositories** (repositories without a `templateUrl` setting): Custom jobs are preserved and applied during updates
414+
- **Final repositories** (repositories with a `templateUrl` pointing to another repository): Custom jobs from the current repository are NOT applied during updates to prevent persistence of jobs removed from the template
412415

413416
**Note** that installing [apps from the GitHub marketplace](https://github.com/marketplace?type=apps) might require you to add custom jobs or steps to some of the workflows to get the right integration. In custom jobs, you can use any [actions from the GitHub marketplace](https://github.com/marketplace?type=actions).
414417

0 commit comments

Comments
 (0)