Merge pull request #43756 from github/repo-sync

Repo sync

Author: docs-bot

assets/images/help/notifications/notifications-general-existence-indicator.png

@@ -23,17 +23,13 @@ Expressions are commonly used with the conditional `if` keyword in a workflow fi
 `${{ <expression> }}`
 {% endraw %}
 
-{% data reusables.actions.expression-syntax-if %} For more information about `if` conditionals, see "[AUTOTITLE](/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idif)."
+{% note %}
 
-{% data reusables.actions.context-injection-warning %}
+**Note**: The exception to this rule is when you are using expressions in an `if` clause, where, optionally, you can usually omit {% raw %}`${{`{% endraw %} and {% raw %}`}}`{% endraw %}. For more information about `if` conditionals, see "[AUTOTITLE](/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idif)."
 
-### Example expression in an `if` conditional
+{% endnote %}
 
-```yaml
-steps:
-  - uses: actions/hello-world-javascript-action@e76147da8e5c81eaf017dede5645551d4b94427b
-    if: <expression> 
-```
+{% data reusables.actions.context-injection-warning %}
 
 ### Example setting an environment variable
 

content/actions/learn-github-actions/expressions.md

@@ -1,5 +1,11 @@
-When you use expressions in an `if` conditional, you may omit the {% raw %}`${{ }}`{% endraw %} expression syntax because {% data variables.product.prodname_actions %} automatically evaluates the `if` conditional as an expression. However, this rule does not apply everywhere.
+When you use expressions in an `if` conditional, you can, optionally, omit the {% raw %}`${{ }}`{% endraw %} expression syntax because {% data variables.product.prodname_actions %} automatically evaluates the `if` conditional as an expression. However, this exception does not apply everywhere.
 
-You must use the {% raw %}`${{ }}`{% endraw %} expression syntax or escape with `''`, `""`,  or `()` when the expression starts with `!`, since `!` is reserved notation in YAML format.
+You must always use the {% raw %}`${{ }}`{% endraw %} expression syntax or escape with `''`, `""`,  or `()` when the expression starts with `!`, since `!` is reserved notation in YAML format. For example:
 
-Using the {% raw %}`${{ }}`{% endraw %} expression syntax turns the contents into a string, and strings are truthy. For example, `if: true && {% raw %}${{ false }}{% endraw %}` will evaluate to `true`.
+{% raw %}
+
+```yaml
+if: ${{ ! startsWith(github.ref, 'refs/tags/') }}
+```
+
+{% endraw %}

data/reusables/actions/expression-syntax-if.md

@@ -1,3 +1,3 @@
-1. In the upper-right corner of any page, click {% octicon "bell" aria-label="You have (no) unread notifications" %}.
+1. In the upper-right corner of any page, click {% octicon "inbox" aria-label="You have (no) unread notifications" %}.
 
-   ![Screenshot of the right corner of the header of GitHub. A bell icon with a blue dot indicating unread notifications is outlined in dark orange.](/assets/images/help/notifications/notifications-general-existence-indicator.png)
+   ![Screenshot of the right corner of the header of GitHub. An inbox icon has a blue dot, indicating that there are unread notifications.](/assets/images/help/notifications/notifications-general-existence-indicator.png)