Swift CI tutorial examples are outdated (Swift 5.2/5.3, setup-swift pinned to a 2021 commit)
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
- Ambito
- ci-cd, documentation
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
Code of Conduct
- I have read and agree to the GitHub Docs project's Code of Conduct
What article on docs.github.com is affected?
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-swiftis 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)
- Update the example Swift versions to current releases.
- Refresh the
swift-actions/setup-swiftSHA pin to its current release, keeping the not-certified-by-GitHub notice and SHA-pinning reusables already used on the page. - Optionally add a short section showing how to build and test on Linux using the official
swiftcontainer images (and theswiftlang/swiftnightly 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
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di github/docs
-
content triage
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 90/100
-
localization triage
Difficoltà 2/5 1-2 giorni Idoneità per principianti 72/100
-
builder persona triage
Difficoltà 2/5 1-3 ore Idoneità per principianti 82/100
-
content localization
Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100
-
content localization
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 92/100