网站现已开源

长期以来, 网站一直是开发者们共同协作开发开源 Swift 编译器、库和工具的中心枢纽。今天,我们很高兴地宣布, 网站本身也已成为一个开源项目,准备好迎接社区贡献。通过此举,网站也在扩展其使命,以更好地支持整个 Swift 用户社区,而不仅仅是贡献者。

为了协助这项工作,将成立一个新的 Swift 网站工作组 (SWWG),以引导网站的发展演进。 令人兴奋的是,可以想象在整个社区的共同参与下,我们网站的未来会变成什么样子。 那么,让我们深入了解这一切意味着什么。

网站目标

网站汇集了各种不同的内容 —— 从每晚构建版本的下载,到社区论坛、文档,以及语言本身的演进提案。 作为一个开源项目,网站的目标也随之增长。 网站应该:

Swift 网站工作组 (SWWG)

Swift 网站工作组 (SWWG) 的章程将是在任何必要的工具和平台上开展工作,以创造真正出色的网络体验,从而实现上述目标。 这包括在主网站、论坛和文档方面的工作。

欢迎任何人为 网站做出贡献。 他们只需创建一个拉取请求 (pull request),其中包含对网站代码库的修复或改进即可。 项目的维护以及社区 PR 的批准将由 SWWG 负责处理,SWWG 由来自广泛 Swift 社区的人员组成。 还有一个论坛供人们讨论该项目。

今天,我们开始接受希望在Swift 网站工作组 (SWWG)中任职的社区成员的提名。 目标是招募五到十名志愿者来管理社区 PR 的日常审查,并指导网站的策略。

希望加入工作组的个人应通过 论坛联系 @swift-website-workgroup 提交申请,说明您感兴趣的原因以及有助于您胜任此职位的特殊技能。 核心团队成员将审查申请,并可能在对首批团队成员进行投票之前提出后续问题。

Swift 中的多元化

与 的其他工作组非常相似,“Swift 中的多元化”团队将与 SWWG 合作,以确保始终考虑整个 Swift 社区的原则和利益。 您可以在此处阅读有关 Swift 网站工作组 (SWWG) 章程的更多信息。

内容类型

网站对社区贡献开放,并具有公开的治理流程。 然而, 上托管的某些内容遵循不同的发布流程,并且不以相同的贡献方式开放。 例如,《Swift 编程语言》书的文本根据 Creative Commons 许可提供,但项目本身尚未开源。 我们计划为此内容采用 Swift-DocC,替换该书当前的自定义发布工具链,以将 TSPL 作为开源项目发布。

博客偶尔会托管一些帖子(例如公告),其中的内容在发布前无法公开分享。 如果您有希望发布的博文草稿,请使用 Swift 论坛将您的博文草稿通过电子邮件发送至 @swift-website-workgroup

从本质上讲,博客文章在发布时具有相关性,并会随着时间的推移而过时。 欢迎提交拉取请求 (pull request) 以修复拼写错误等小问题,无论文章发布时间多久。 发布后对博文的重大更改应不频繁 —— 例如,当 API 或最佳实践发生变化时,无需修订旧的博文。

GitHub 上的代码库

网站现在已在 GitHub 上公开。 网站代码库还将使用 GitHub Issues 进行问题跟踪。 我们希望这将使人们更容易参与进来,并为 Swift 项目的其余部分将来迁移到 Issues 提供试验平台。

下一步

要阅读有关 SWWG 的完整详细信息,请查看

工作组的首要任务之一是确定构建网站的未来技术堆栈。 例如,文档样式的页面可以迁移到 Swift-DocC。 使用基于 Swift 的工具替换 Jekyll 可能会更好。 其他工作可能包括设计新的“入门指南”内容,以使网站更受欢迎。

如果您想加入工作组,请尽快发送电子邮件表达您的兴趣。 目标是在 2022 年 4 月底之前确定首批成员。