Skip to content

Commit b2d8bee

Browse files
committed
Use non-version specific reference URLs for tool version workflow variables
GitHub Actions actions are used by the workflows to set up development tools in the runner workspace. In order to facilitate updates to new versions of these tools, we set the version to be set up via environment variables at the top of the workflow. Since this variable definition is separate from the step using the action, it might not be immediately apparent to the maintainer which version syntaxes are supported. For this reason, comments were added with the URL to the relevant section of the consuming action's documentation. Previously, these URLs were made to point to the version of the documentation that matched the version of the action in use by the workflow. Since we only use a major version ref, the expectation was that this would only need to be updated rarely. However, it turned out that the major version bump cycle is significantly shorter than expected. In addition, it is easy to forget the update because action version update PRs are provided by Dependabot, which obviously won't update the URLs in the comments. So it will be best to use a URL that points to the documentation at the tip of the default branch of the action repository. The likelihood of the documentation provided by this URL not matching the behavior of the release version of the action in use is likely less than it is for an outdated URL.
1 parent 9b86689 commit b2d8bee

File tree

4 files changed

+4
-4
lines changed

4 files changed

+4
-4
lines changed

.github/workflows/check-go-dependencies-task.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
name: Check Go Dependencies
33

44
env:
5-
# See: https://github.com/actions/setup-go/tree/v3#readme
5+
# See: https://github.com/actions/setup-go/tree/main#supported-version-syntax
66
GO_VERSION: "1.17"
77

88
# See: https://docs.github.com/actions/using-workflows/events-that-trigger-workflows

.github/workflows/check-go-task.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
name: Check Go
33

44
env:
5-
# See: https://github.com/actions/setup-go/tree/v2#readme
5+
# See: https://github.com/actions/setup-go/tree/main#supported-version-syntax
66
GO_VERSION: "1.17"
77

88
# See: https://docs.github.com/en/actions/reference/events-that-trigger-workflows

.github/workflows/check-yaml-task.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
name: Check YAML
33

44
env:
5-
# See: https://github.com/actions/setup-python/tree/v3#available-versions-of-python
5+
# See: https://github.com/actions/setup-python/tree/main#available-versions-of-python
66
PYTHON_VERSION: "3.9"
77

88
# See: https://docs.github.com/en/actions/reference/events-that-trigger-workflows

.github/workflows/spell-check-task.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
name: Spell Check
33

44
env:
5-
# See: https://github.com/actions/setup-python/tree/v3#available-versions-of-python
5+
# See: https://github.com/actions/setup-python/tree/main#available-versions-of-python
66
PYTHON_VERSION: "3.9"
77

88
# See: https://docs.github.com/en/free-pro-team@latest/actions/reference/events-that-trigger-workflows

0 commit comments

Comments
 (0)