diff --git a/content/actions/reference/workflows-and-actions/contexts.md b/content/actions/reference/workflows-and-actions/contexts.md index 73f4e13158f9..be3a45d835ae 100644 --- a/content/actions/reference/workflows-and-actions/contexts.md +++ b/content/actions/reference/workflows-and-actions/contexts.md @@ -730,6 +730,8 @@ There are no standard properties in the `matrix` context, only those which are d | `matrix` | `object` | This context is only available for jobs in a matrix, and changes for each job in a workflow run. You can access this context from any job or step in a workflow. This object contains the properties listed below. | | `matrix.` | `string` | The value of a matrix property. | +{% data reusables.actions.workflows.matrix-keys-are-case-insensitive %} + ### Example contents of the `matrix` context The following example contents of the `matrix` context is from a job in a matrix that has the `os` and `node` matrix properties defined in the workflow. The job is executing the matrix combination of an `ubuntu-latest` OS and Node.js version `16`. diff --git a/content/actions/reference/workflows-and-actions/workflow-syntax.md b/content/actions/reference/workflows-and-actions/workflow-syntax.md index bef2d287efba..f21517189d49 100644 --- a/content/actions/reference/workflows-and-actions/workflow-syntax.md +++ b/content/actions/reference/workflows-and-actions/workflow-syntax.md @@ -1242,6 +1242,8 @@ A matrix will generate a maximum of 256 jobs per workflow run. This limit applie The variables that you define become properties in the `matrix` context, and you can reference the property in other areas of your workflow file. In this example, you can use `matrix.version` and `matrix.os` to access the current value of `version` and `os` that the job is using. For more information, see [AUTOTITLE](/actions/reference/workflows-and-actions/contexts). +{% data reusables.actions.workflows.matrix-keys-are-case-insensitive %} + By default, {% data variables.product.github %} will maximize the number of jobs run in parallel depending on runner availability. The order of the variables in the matrix determines the order in which the jobs are created. The first variable you define will be the first job that is created in your workflow run. ### Using a single-dimension matrix diff --git a/data/reusables/actions/workflows/matrix-keys-are-case-insensitive.md b/data/reusables/actions/workflows/matrix-keys-are-case-insensitive.md new file mode 100644 index 000000000000..c8afe51ec74f --- /dev/null +++ b/data/reusables/actions/workflows/matrix-keys-are-case-insensitive.md @@ -0,0 +1,2 @@ +> [!NOTE] +> The variable names are case insensitive. For example, `OS` and `os` will be treated as the same variable.