Swift CI tutorial examples are outdated (Swift 5.2/5.3, setup-swift pinned to a 2021 commit)

オープン 初心者向け
#44,868 コメント 1 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
68/100
issue の種類
ドキュメント
明瞭さ
おおむね明確
活発さ
静か
技術スタック
github-actions, swift

調査の方向性

content/actions/tutorials/build-and-test-code/swift.md から始め、既存の Swift バージョンマトリックス、単一バージョンの例、setup-swift の SHA pin を確認します。オプションのクロスプラットフォーム用資料を変更する前に、想定される範囲を確認してください。例で現在の Swift リリースを使用し、アクションの pin が更新され、既存の注意書きと再利用可能なガイダンスがそのまま維持されていれば完了です。

索引モデルが issue の本文から書いたものです。

説明

Closed as inactive content github_actions never-stale triage
Code of Conduct
What article on docs.github.com is affected?

Building and testing Swift

Source file: content/actions/tutorials/build-and-test-code/swift.md

What part(s) of the article would you like to see updated?

The tutorial's examples have aged and no longer reflect current Swift CI practice:

  • Swift versions are several years old. The matrix example uses swift: ["5.2", "5.3"] and the single-version examples use "5.3.3". Swift is now on the 6.x series (current release 6.3).
  • swift-actions/setup-swift is pinned to a 2021 commit (65540b95f51493d65f5e59e97dcef9629ddf11bf). The action's current release is v2.4.0 (November 2025). This is the same kind of staleness previously reported in #12678.
Proposed changes (the uncontroversial refresh)
  1. Update the example Swift versions to current releases.
  2. Refresh the swift-actions/setup-swift SHA pin to its current release, keeping the not-certified-by-GitHub notice and SHA-pinning reusables already used on the page.
  3. Optionally add a short section showing how to build and test on Linux using the official swift container images (and the swiftlang/swift nightly images), which doesn't require a separate Swift-setup step.
A question before I open a PR

Swift CI today commonly spans more than Ubuntu/macOS swift build — Apple platforms via Xcode, plus Windows, Android, and WebAssembly. Would the team be open to a brief cross-platform section that demonstrates these, including links to community actions (for example compnerd/gha-setup-swift for Windows and skiptools/swift-android-action for Android)?

I'd like to confirm this fits the docs' guidance on mentioning third-party tools before investing in a larger PR. For transparency: one action I might reference, brightdigit/swift-build, is one I maintain, so I'd want any mention to be neutral and in line with how the page already references swift-actions/setup-swift.

Happy to scope the PR to just items 1–2 (or 1–3) if that's preferable.

Additional information

No response

主要言語
TypeScript
スター
20.9k
フォーク
68.8k
平均マージ
15時間 4分
マージ済み PR(30日)
103

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

github/docs のほかの issue

github/docs の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。