Update documentation

Author: cedric-anne

README.md

@@ -2,7 +2,7 @@
 
 ## Continuous integration workflow
 
-This workflow will execute the following actions as long as they are available on the checked repository.
+This workflow will execute the following actions as long as they are available on the plugin repository.
 
 | Action | Required package | Required config file |
 | -------- | -------- | -------- |
@@ -15,8 +15,42 @@ This workflow will execute the following actions as long as they are available o
 | PHPUnit | [phpunit/phpunit](https://packagist.org/packages/phpunit/phpunit) | `phpunit.xml` |
 | Jest | [jest](https://www.npmjs.com/package/jest) | `jest.config.js` |
 
-You can use this workflow in any plugin using the following Github Actions configuration.
-You will have to use your plugin system name in the `plugin-key` parameter.
+```yaml
+name: "Continuous integration"
+
+on:
+  pull_request:
+
+jobs:
+  ci:
+    uses: "glpi-project/plugin-ci-workflows/.github/workflows/continuous-integration.yml@v1"
+    with:
+      # The plugin key (system name).
+      plugin-key: "myplugin"
+
+      # The version of GLPI on which to run the tests.
+      glpi-version: "10.0.x"
+
+      # The version of PHP on which to run the tests.
+      php-version: "8.1"
+
+      # The database docker image on which to run the tests.
+      db-image: "10.6"
+```
+
+The available `glpi-version`/`php-version` combinations corresponds to the `ghcr.io/glpi-project/githubactions-glpi` images tags
+that can be found [here](https://github.com/orgs/glpi-project/packages/container/githubactions-glpi/versions?filters%5Bversion_type%5D=tagged).
+
+The `db-image` parameter is a combination of the DB server engine (`mysql`, `mariadb` or `percona`) and the server version.
+- MariaDB available versions are listed [here](https://github.com/orgs/glpi-project/packages/container/githubactions-mariadb/versions?filters%5Bversion_type%5D=tagged)
+- MySQL available versions are listed [here](https://github.com/orgs/glpi-project/packages/container/githubactions-mysql/versions?filters%5Bversion_type%5D=tagged).
+- Percona available versions are listed [here](https://github.com/orgs/glpi-project/packages/container/githubactions-percona/versions?filters%5Bversion_type%5D=tagged).
+
+## Generate CI matrix
+
+This workflow can be used to generate a matrix that contains all the PHP/SQL versions that are supported by the target GLPI version.
+You can use it in combination with the `Continuous Integration` workflow to execute the continuous integration
+test suite on all PHP/SQL versions supported by the target version of GLPI, as shown in the example below.
 
 ```yaml
 name: "Continuous integration"
@@ -30,28 +64,28 @@ on:
   pull_request:
   schedule:
     - cron: "0 0 * * *"
+  workflow_dispatch:
+
+concurrency:
+  group: "${{ github.workflow }}-${{ github.ref }}"
+  cancel-in-progress: true
 
 jobs:
+  generate-ci-matrix:
+    name: "Generate CI matrix"
+    uses: "glpi-project/plugin-ci-workflows/.github/workflows/generate-ci-matrix.yml@v1"
+    with:
+      glpi-version: "10.0.x"
   ci:
     name: "GLPI ${{ matrix.glpi-version }} - php:${{ matrix.php-version }} - ${{ matrix.db-image }}"
+    needs: "generate-ci-matrix"
     strategy:
       fail-fast: false
-      matrix:
-        include:
-          - {glpi-version: "10.0.x", php-version: "7.4", db-image: "mysql:5.7"}
-          - {glpi-version: "10.0.x", php-version: "8.2", db-image: "mariadb:10.6"}
+      matrix: ${{ fromJson(needs.generate-ci-matrix.outputs.matrix) }}
     uses: "glpi-project/plugin-ci-workflows/.github/workflows/continuous-integration.yml@v1"
     with:
       plugin-key: "myplugin"
       glpi-version: "${{ matrix.glpi-version }}"
       php-version: "${{ matrix.php-version }}"
       db-image: "${{ matrix.db-image }}"
 ```
-
-The available `glpi-version`/`php-version` combinations corresponds to the `ghcr.io/glpi-project/githubactions-glpi` images tags
-that can be found [here](https://github.com/orgs/glpi-project/packages/container/githubactions-glpi/versions?filters%5Bversion_type%5D=tagged).
-
-The `db-image` parameter is a combination of the DB server engine (`mysql`, `mariadb` or `percona`) and the server version.
-- MariaDB available versions are listed [here](https://github.com/orgs/glpi-project/packages/container/githubactions-mariadb/versions?filters%5Bversion_type%5D=tagged)
-- MySQL available versions are listed [here](https://github.com/orgs/glpi-project/packages/container/githubactions-mysql/versions?filters%5Bversion_type%5D=tagged).
-- Percona available versions are listed [here](https://github.com/orgs/glpi-project/packages/container/githubactions-percona/versions?filters%5Bversion_type%5D=tagged).