Swift CI tutorial examples are outdated (Swift 5.2/5.3, setup-swift pinned to a 2021 commit)
还没有人认领这个 Issue。
评估
- 难度
- 2/5
- 预计耗时
- 1-3 小时
- 新手友好度
- 68/100
- Issue 类型
- 文档
- 描述清晰度
- 基本清楚
- 活跃度
- 冷清
- 技术栈
- github-actions, swift
- 领域
- ci-cd, documentation
调研方向
从 content/actions/tutorials/build-and-test-code/swift.md 开始,检查现有的 Swift 版本矩阵、单版本示例以及 setup-swift 的 SHA pin。在更改可选的跨平台材料之前,确认预期范围;完成标准是示例使用当前的 Swift 版本、action pin 已刷新,并且现有通知和可复用指南保持不变。
由索引模型根据 Issue 内容生成。
描述
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
- 主要语言
- TypeScript
- 星标
- 20.9k
- 派生
- 68.8k
- 平均合并
- 15 小时 4 分钟
- 30 天内合并 PR
- 103
贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
github/docs 的其他 Issue
-
builder persona content
难度 1/5 1 小时以内 新手友好度 90/100
-
localization
难度 2/5 1-2 天 新手友好度 72/100
-
builder persona
难度 2/5 1-3 小时 新手友好度 82/100
-
content localization
难度 2/5 1-3 小时 新手友好度 78/100
-
content localization
难度 1/5 1 小时以内 新手友好度 92/100
相似的 Issue
-
难度 2/5 1-3 小时 新手友好度 84/100
copse-dev/agent-pane#2953 ·
-
难度 2/5 1-3 小时 新手友好度 84/100
Eynzof/Hermes-CN-Desktop#610 ·
-
bug clawsweeper:linked-pr-open clawsweeper:needs-live-repro clawsweeper:no-new-fix-pr impact:message-loss issue-rating: 🐚 platinum hermit P2 regression
难度 2/5 1-3 小时 新手友好度 78/100
-
enhancement
难度 2/5 1-3 小时 新手友好度 68/100
-
calcite-components needs triage refactor
难度 2/5 1-3 小时 新手友好度 75/100
Esri/calcite-design-system#15203 ·