Be more precise when expression syntax ${{ }} can be omitted in if statement

[programmer04]

Why:

Unfortunately, you can't always omit ${{ }} in the if statement and it's not documented anywhere. Consider below examples

name: test-expression

on:
  push:
    branches:
      - main

jobs:
    test:
        runs-on: ubuntu-latest
        steps:
        - run: echo 'Hello, world!'
    statement-if:
        runs-on: ubuntu-latest
        if: github.event_name == 'push' && !startsWith(github.ref, 'refs/heads/')
        steps:
        - run: echo 'Summer!'

the above works as expected, but the below that only differs by order of statements in if doesn't work

name: test-expression

on:
  push:
    branches:
      - main

jobs:
    test:
        runs-on: ubuntu-latest
        steps:
        - run: echo 'Hello, world!'
    statement-if:
        runs-on: ubuntu-latest
        if: !startsWith(github.ref, 'refs/heads/') && github.event_name == 'push'
        steps:
        - run: echo 'Summer!'

ends with

This is due to the YAML format see

• https://github.com/orgs/community/discussions/26303#discussioncomment-6739171
• https://github.com/orgs/community/discussions/26386#discussioncomment-3251729

basically, it can't start with !, because it has meaning in YAML specification.

In my opinion, it's a pain to have it like that and it should be forbidden at all or work as expected even at the cost of breaking a little bit of specification of YAML. It should be reported to the team responsible for GitHub Workflows to take some action.

What's being changed (if available, include any code snippets, screenshots, or gifs):

The description for the if conditional.

Check off the following:

• I have reviewed my changes in staging, available via the View deployment link in this PR's timeline.

  • For content changes, you will also see an automatically generated comment with links directly to pages you've modified. The comment won't appear if your PR only edits files in the data directory.

• For content changes, I have completed the self-review checklist.

[cmwilson21]

@programmer04 Thanks so much for submitting a PR! I'll get this triaged for review ⚡

[jc-clark]

Thank you @programmer04 for finding this and helping with the fix!

While I was searching around the other articles, I found some text on if conditionals in the "Variables" article as well.

What do you think about updating this line with the same text?

[programmer04]

Thanks for the review and suggestion @jc-clark! For this syntax, it's even a little bit more complicated, because you can also write such expressions as if: !cancelled as e.g.:

• if: '!cancelled'
• if: (!cancelled)

read discussion and the other

[jc-clark]

🤔 I see what you're saying @programmer04. I think it would make sense to document the two examples you listed.

I think the paragraph in the data/reusables/actions/expression-syntax-if.md reusable is starting to get a bit long and difficult to understand. Ideally we can split this paragraph into a couple smaller paragraphs.

There's one problem though. We can't just add line breaks because the reusable also exists in a bulleted list on this line. Adding line breaks will break the formatting in the bulleted list.

It seems to me that we can delete this bullet point in the note since the same information is at the top of the article. Then we'd be able to add some line breaks and more information to the reusable.

What do you think of that?

[cmwilson21]

👋 @programmer04 - just checking in. Is this one ready for another review?

[github-actions]

Automatically generated comment ℹ️

This comment is automatically generated and will be overwritten every time changes are committed to this branch.

The table contains an overview of files in the content directory that have been changed in this pull request. It's provided to make it easy to review your changes on the staging site. Please note that changes to the data directory will not show up in this table.

---

Content directory changes

You may find it useful to copy this table into the pull request summary. There you can edit it to share links to important articles or changes and to give a high-level overview of how the changes in your pull request support the overall goals of the pull request.

Source	Preview	Production	What Changed
actions/learn-github-actions/expressions.md	fpt ghec ghes@ 3.10 3.9 3.8 3.7 3.6 ghae	fpt ghec ghes@ 3.10 3.9 3.8 3.7 3.6 ghae

---

fpt: Free, Pro, Team
ghec: GitHub Enterprise Cloud
ghes: GitHub Enterprise Server
ghae: GitHub AE

[programmer04]

I made suggested adjustments, it's ready for review @jc-clark and @cmwilson21. Btw. it would be easier if GH would always require ${{ }} in if statements 😅

[jc-clark]

Looks great to me. Many thanks for helping keep this updated @programmer04. I'll get this set up to merge.

[github-actions]

Thanks very much for contributing! Your pull request has been merged 🎉 You should see your changes appear on the site in approximately 24 hours. If you're looking for your next contribution, check out our help wanted issues ⚡