Clarify case-(in)sensitivity for `matrix.<keys>`

Open Beginner friendly
#27,200 16 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
68/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Quiet
Tech stack
github-actions
Domain
documentation

Research direction

Start with the workflow syntax article and the matrix context section linked in the issue, focusing on how matrix keys and values are described. Confirm the case-sensitivity behavior from the surrounding documentation, then add a clear indication in the affected article or articles and verify the wording is consistent with existing case-sensitivity notes.

Written by the indexing model from the issue text.

Description

actions content never-stale waiting for review
Code of Conduct
What article on docs.github.com is affected?

https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions
https://docs.github.com/en/actions/learn-github-actions/contexts#matrix-context

What part(s) of the article would you like to see updated?

Add an indication whether or not matrix elements are case sensitive.

Additional information

Some sections indicate if items are case sensitive / case insensitive.

Developers of one project w/ which I have some affiliation were asking whether matrix.<key> would be case sensitive.

Here's a subset of the workflow they had:

jobs:
  linux:
    strategy:
      fail-fast: false
      matrix:
        arch:
          - amd64
        include:
          - arch: amd64
            CC: x86_64-linux-gnu
          - arch: arm64
            CC: aarch64-linux-gnu
    runs-on: ubuntu-22.04
    env:
      AR: ${{ matrix.CC }}-ar
      CHOST: ${{ matrix.cc }}
      CC: ${{ matrix.cc }}-gcc
      CPP: ${{ matrix.cc }}-cpp
      CXX: ${{ matrix.cc }}-g++
Dominant language
TypeScript
Stars
20.9k
Forks
68.8k
Avg merge
15h 4m
Merged PRs (30d)
103

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from github/docs

All issues in github/docs

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.