网站治理

请参阅网站概览,了解关于 网站目标和贡献指南的更多信息。

本网站有一个小型的维护者列表,他们拥有写入权限,负责审核和合并来自贡献者的拉取请求。维护者组由 Swift 核心团队和Swift 网站工作组成员的一小部分组成。

网站源代码由几个不同的部分组成

  1. 通用内容:Markdown、HTML、数据文件、图像和其他内容。
  2. 博客文章:博客文章的源文件,主要为 Markdown 格式。
  3. 技术基础设施:用于从其他形式的文本内容(如 Markdown 和 HTML 文件)生成网站最终静态内容(主要是 HTML)的代码和脚本。
  4. 信息设计、用户体验和用户界面设计:网站的布局和导航,包括用于定义用户体验和用户界面的 CSS 和图像。

这些领域中的每一个都由略有不同的贡献流程管理,以匹配其性质。

通用内容治理

对现有内容(博客文章除外)的增量更新通过提交拉取请求完成,并将由网站维护者审核。通常,这些拉取请求将用于纠正或改进现有主题。

对内容的较大更改,例如引入广泛的新主题,需要与网站工作组协商,以确定适当的导航结构和其他信息设计问题。此类更广泛的更改可以通过公共论坛帖子提出,也可以通过在 Swift 论坛上联系网站工作组 @swift-website-workgroup 更私密地提出。

博客文章治理

博客旨在让 Swift 社区了解语言、生态系统的最新发展以及社区新闻。它是一个分享语言路线图、有趣的新功能、库和工具以及宣布项目和社区倡议的平台。

博客也是一个认可和突出我们社区成员所做工作的机会,我们欢迎通过博客文章贡献流程投稿。

Swift 库文档和“Swift 编程语言”

网站托管了几个 Swift 库的技术文档,以及“Swift 编程语言”。

这些技术文档不是网站内容的一部分,仅作为网站的一部分重新发布。因此,这些技术文档不受本贡献指南的约束。

技术基础设施治理

对网站技术基础设施的增量修复和改进通过提交拉取请求完成,并将由网站维护者审核。

与内容更改相比,技术基础设施更改需要经过更多测试,以确保它们在 macOS 和 Linux 上都能正常工作,macOS 和 Linux 是网站的主要开发环境。

信息设计、用户体验和用户界面设计治理

对网站样式的增量修复和改进通过提交拉取请求完成,并将由网站维护者审核。

对导航、用户体验和用户界面的较大更改,需要与网站工作组协商,以确定适当的方法。此类更广泛的更改可以通过公共论坛帖子提出,也可以通过在 Swift 论坛上联系网站工作组 @swift-website-workgroup 更私密地提出。