Skip to content

Commit d2ad281

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 specify the tool 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 to update the URLs because action version update PRs are provided by Dependabot, which obviously won't update the comments for us. 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 the inevitably outdated URLs resulting from the previous approach.
1 parent 8be858d commit d2ad281

30 files changed

+32
-32
lines changed

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

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
name: Check Python
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/actions/using-workflows/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/actions/using-workflows/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/actions/using-workflows/events-that-trigger-workflows

.github/workflows/test-python-poetry-task.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
name: Test Python
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/actions/using-workflows/events-that-trigger-workflows

workflow-templates/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

workflow-templates/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/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

workflow-templates/check-mkdocs-task.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
name: Check Website
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/actions/using-workflows/events-that-trigger-workflows

workflow-templates/check-python-task.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
name: Check Python
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/actions/using-workflows/events-that-trigger-workflows

workflow-templates/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/actions/using-workflows/events-that-trigger-workflows

workflow-templates/dependabot/workflow-template-copies/.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

workflow-templates/dependabot/workflow-template-copies/.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/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

workflow-templates/dependabot/workflow-template-copies/.github/workflows/check-mkdocs-task.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
name: Check Website
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/actions/using-workflows/events-that-trigger-workflows

workflow-templates/dependabot/workflow-template-copies/.github/workflows/check-python-task.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
name: Check Python
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/actions/using-workflows/events-that-trigger-workflows

workflow-templates/dependabot/workflow-template-copies/.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/actions/using-workflows/events-that-trigger-workflows

workflow-templates/dependabot/workflow-template-copies/.github/workflows/deploy-cobra-mkdocs-versioned-poetry.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
name: Deploy Website
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
on:

workflow-templates/dependabot/workflow-template-copies/.github/workflows/deploy-mkdocs-poetry.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
name: Deploy Website
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/actions/using-workflows/events-that-trigger-workflows

workflow-templates/dependabot/workflow-template-copies/.github/workflows/deploy-mkdocs-versioned-poetry.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
name: Deploy Website
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
on:

workflow-templates/dependabot/workflow-template-copies/.github/workflows/release-go-crosscompile-task.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ env:
99
# The project's folder on Arduino's download server for uploading builds
1010
AWS_PLUGIN_TARGET: TODO_AWS_PLUGIN_TARGET
1111
ARTIFACT_NAME: dist
12-
# See: https://github.com/actions/setup-go/tree/v3#readme
12+
# See: https://github.com/actions/setup-go/tree/main#supported-version-syntax
1313
GO_VERSION: "1.17"
1414

1515
on:

workflow-templates/dependabot/workflow-template-copies/.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/actions/using-workflows/events-that-trigger-workflows

workflow-templates/dependabot/workflow-template-copies/.github/workflows/test-go-integration-task.yml

+2-2
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,9 @@
22
name: Test Integration
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"
7-
# See: https://github.com/actions/setup-python/tree/v3#available-versions-of-python
7+
# See: https://github.com/actions/setup-python/tree/main#available-versions-of-python
88
PYTHON_VERSION: "3.9"
99

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

workflow-templates/dependabot/workflow-template-copies/.github/workflows/test-go-task.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
name: Test Go
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

workflow-templates/dependabot/workflow-template-copies/.github/workflows/test-python-poetry-task.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
name: Test Python
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/actions/using-workflows/events-that-trigger-workflows

workflow-templates/deploy-cobra-mkdocs-versioned-poetry.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
name: Deploy Website
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
on:

workflow-templates/deploy-mkdocs-poetry.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
name: Deploy Website
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/actions/using-workflows/events-that-trigger-workflows

workflow-templates/deploy-mkdocs-versioned-poetry.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
name: Deploy Website
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
on:

workflow-templates/release-go-crosscompile-task.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ env:
99
# The project's folder on Arduino's download server for uploading builds
1010
AWS_PLUGIN_TARGET: TODO_AWS_PLUGIN_TARGET
1111
ARTIFACT_NAME: dist
12-
# See: https://github.com/actions/setup-go/tree/v3#readme
12+
# See: https://github.com/actions/setup-go/tree/main#supported-version-syntax
1313
GO_VERSION: "1.17"
1414

1515
on:

workflow-templates/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/actions/using-workflows/events-that-trigger-workflows

workflow-templates/test-go-integration-task.yml

+2-2
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,9 @@
22
name: Test Integration
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"
7-
# See: https://github.com/actions/setup-python/tree/v3#available-versions-of-python
7+
# See: https://github.com/actions/setup-python/tree/main#available-versions-of-python
88
PYTHON_VERSION: "3.9"
99

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

workflow-templates/test-go-task.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
name: Test Go
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

workflow-templates/test-python-poetry-task.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
name: Test Python
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/actions/using-workflows/events-that-trigger-workflows

0 commit comments

Comments
 (0)