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

Aperta Adatta ai principianti
#44,868 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
68/100
Tipo di issue
Documentazione
Chiarezza
Abbastanza chiara
Stato di attività
Tranquilla
Stack tecnologico
github-actions, swift

Direzione di ricerca

Inizia da content/actions/tutorials/build-and-test-code/swift.md e rivedi la matrice delle versioni Swift esistente, gli esempi a versione singola e lo SHA pin di setup-swift. Conferma l’ambito previsto prima di modificare il materiale multipiattaforma facoltativo; il lavoro è completo quando gli esempi usano versioni correnti di Swift, il pin dell’azione è aggiornato e gli avvisi esistenti e la guida riutilizzabile rimangono intatti.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

content github_actions Inactive
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

Lingua principale
TypeScript
Stelle
20.9k
Fork
68.8k
Merge medio
15h 4m
PR unite (30g)
103

Guida per i contributori

Apri la guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di github/docs

Tutte le issue di github/docs

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.