* 🔒 Document how to use secrets with `if:`
github/docs#6861github/docs#12722
- Add a complete workflow example to `jobs.<job_id>.steps[*].if`,
demonstrating how to skip a step if a secret is not present
- Add an explanation to "Using encrypted secrets in a workflow"
- Cross-reference the two pages
* 🔒 Compare secrets with empty strings in `if:`
github/docs#6861https://github.com/github/docs/pull/12722#discussion_r801011000
Rather than referencing two secrets:
1. `${{ secrets.SECRET_IS_SET }}`
2. `${{ secrets.SECRET_IS_NOT_SET }}`)
This commit will update the related section of the docs to reference a
single secret (`${{ secrets.SECRET_IS_SET }}`), and will update the
`if:` conditionals to compare with empty strings as suggested.
* 🔒 Add missing `{% raw %}`/`{% endraw %}`
github/docs#6861github/docs#12722
Some `${{ }}` values were converted to `$` in the preview environment.
Adding `{% raw %}`/`{% endraw %}` will preserve the raw value.
* 🔒 Match variable and secret names in examples
github/docs#6861https://github.com/github/docs/pull/12722#discussion_r801011000
This PR adds an example of how to use secrets with `if:` conditionals.
The reviewer suggested comparing variable values with empty strings to
make the `if:` conditionals clearer.
Commit cecdf00 updated the secret names accordingly, but the names of
the secret and environment variable may still have been confusing.
This commit will update the secret and environment variable names to
match the cross-referenced example on the "Encrypted secrets" page.
* Update content/actions/using-workflows/workflow-syntax-for-github-actions.md
Co-authored-by: hubwriter <hubwriter@github.com>
* Deprecate 3.0
* 3.0 deprecation: remove 3.0 markup (#25647)
* Remove liquid conditionals and content for 3.0 deprecation
* Remove manually, no longer versioned in a supported version
* Remove translations manually, no longer versioned in a supported version
* Remove 'if', now in all supported versions
* Remove dangling 'elseif', now in all supported versions
* Remove dangling 'elseif' and 3.0 screenshot reference, now in all supported versions
* Nudge to latest supported GHES version
* Nudge to latest supported release GHES version
* Bump all the version for the liquid tests
* Bump first deprecated version for linting tests
* Prefer double quotes
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Prefer double quotes
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Prefer double quotes
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Prefer double quotes
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Prefer double quotes
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Prefer double quotes
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Prefer double quotes
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Prefer double quotes
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Prefer double quotes
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Remove extra newline
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Remove extra newline
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Remove extra newline
Co-authored-by: Laura Coursen <lecoursen@github.com>
* One reusable per line
Co-authored-by: Laura Coursen <lecoursen@github.com>
* One reusable per line
Co-authored-by: Laura Coursen <lecoursen@github.com>
* One reusable per line
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Version check not needed anymore
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Version check not needed anymore
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Version check not needed anymore
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Version check not needed anymore
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Version check not needed anymore
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Version check not needed anymore
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Version check not needed anymore
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Stray whitespace ✂️
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Stray whitespace ✂️
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Stray whitespace ✂️
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Stray whitespace ✂️
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Stray whitespace ✂️
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Stray whitespace ✂️
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Stray whitespace ✂️
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Stray whitespace ✂️
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Version check not needed anymore
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Version check not needed anymore
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Just 'ghes' since we're deprecating 3.0
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Just 'ghes' since we're deprecating 3.0
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Just 'ghes' since we're deprecating 3.0
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Just 'ghes' since we're deprecating 3.0
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Just 'ghes' since we're deprecating 3.0
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Just 'ghes' since we're deprecating 3.0
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Just 'ghes' since we're deprecating 3.0
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Just 'ghes' since we're deprecating 3.0
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Don't depend on hardcoded versions
Co-authored-by: Laura Coursen <lecoursen@github.com>
* Remove static files for 3.0 deprecation (#25649)
Co-authored-by: Laura Coursen <lecoursen@github.com>
The docs currently state:
> Reusable workflows are YAML-formatted files, very similar to any other workflow file. As with other workflow files, you locate reusable workflows in the `.github/workflows` directory of a repository. Subdirectories of the `workflows` directory are not supported.
But the example yml then presents the path `uses: ./.github/actions/my-action` which doesn't follow the initial advice about location of workflow files.
Change is to use `uses: ./.github/workflows/my-action` to make example valid, but this is assuming the `Creating a reusable workflow` section is also accurate.
