[BUG]: github_branch_proctection status checks with matrix values don't work as documented

[joscha]

Expected Behavior

The documentation:

terraform-provider-github/website/docs/r/branch_protection.html.markdown

Line 117 in 5809617

For workflows that use matrixes, append the matrix name to the value using the following pattern `(<matrix_value>[, <matrix_value>])`. Matrixes should be specified based on the order of matrix properties in the workflow file. See [GitHub Documentation]("https://docs.github.com/en/actions/using-jobs/using-a-matrix-for-your-jobs#using-a-matrix-strategy") for more information.

i.e.:

For workflows that use matrixes, append the matrix name to the value using the following pattern (<matrix_value>[, <matrix_value>])

suggests that for a workflow file looking like this:

jobs:
  build:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        avsc: [5.7.x, 6.0.0-alpha.14]
    steps:

(see actual file here)

something like this:

  required_status_checks {
    strict   = true
    contexts = ["build (5.7.x, 6.0.0-alpha.14)", "npm"]
  }

should produce status checks for each of the matrix items, but it doesn't.

Only specifying it like this:

  required_status_checks {
    strict   = true
    contexts = ["build (5.7.x)", "build (6.0.0-alpha.14)", "npm"]
  }

produces two separate required checks correctly.

I have tried finding the code that supposedly handles the special matrix notation, but couldn't find so in 5809617. Nor can I find it in the history or any other issues or mention of matrix related to it anywhere in the codebase.

If I am holding it wrong, please take my apologies. If you could point me to the code handling this special case, that would be great, too.

Actual Behavior

It produces a required status check that verbatim requires a name with all matrix values, which is never fulfilled.

Terraform Version

Terraform 1.9.7 on Mac OS 14.6.1 (23G93) with terraform-provider-github 6.2.1

Affected Resource(s)

• github_branch_proctection

Terraform Configuration Files

No response

Steps to Reproduce

No response

Debug Output

# github_branch_protection.avsc-zstandard-codec-main will be updated in-place
  ~ resource "github_branch_protection" "avsc-zstandard-codec-main" {
        id                              = "BPR_kwDOMyV5ps4DPyW7"
        # (10 unchanged attributes hidden)

      ~ required_status_checks {
          ~ contexts = [
              - "build (5.7.x)",
              + "build (5.7.x, 6.0.0-alpha.14)",
                # (1 unchanged element hidden)
            ]
            # (1 unchanged attribute hidden)
        }
    }

Panic Output

No response

Code of Conduct

• I agree to follow this project's Code of Conduct