Swift.org 网站治理
有关 Swift.org 网站目标和贡献指南的更多信息,请参阅网站概述。
网站有一小部分维护者,他们拥有写入权限,负责审查和合并贡献者的拉取请求。维护者组由 Swift 核心团队和 Swift 网站工作组成员的一小部分成员组成。
Swift.org 网站源代码由以下几个不同部分组成:
- 一般内容:Markdown、HTML、数据文件、图片和其他内容。
- 博客文章:博客文章的源文件,主要是 markdown 格式。
- 技术基础设施:用于将其他形式的文本内容(如 Markdown 和 HTML 文件)生成网站最终静态内容(主要是 HTML)的代码和脚本。
- 信息设计、用户体验和用户界面设计:网站的布局和导航,包括用于定义用户体验和用户界面的 CSS 和图片。
这些领域中的每一个都有略微不同的贡献流程,以适应其特性。
一般内容治理
对现有内容(博客文章除外)的增量更新通过提交拉取请求完成,并将由网站维护者审查。通常,这些拉取请求用于纠正或改进现有主题。
对内容的较大更改,如引入广泛的新主题,需要与网站工作组协商,以决定适当的导航结构和其他信息设计问题。此类更广泛的更改可以通过公共论坛帖子提出,也可以通过在 Swift 论坛上联系网站工作组 @swift-website-workgroup 私下提出建议。
博客文章治理
Swift.org 博客旨在让 Swift 社区了解该语言、其生态系统的最新发展以及社区新闻。它是分享语言路线图、有趣的新功能、库和工具,以及宣布项目和社区倡议的平台。
博客也是一个认可和突出社区成员工作的机会,我们欢迎通过博客文章贡献流程投稿。
Swift 库文档和《Swift 编程语言》
Swift.org 网站托管了几个 Swift 库的技术文档,以及《Swift 编程语言》。
这些技术文档不是网站内容的一部分,仅作为网站的一部分重新发布。因此,这些技术文档不受本贡献指南的管理。
技术基础设施治理
对网站技术基础设施的增量修复和改进通过提交拉取请求完成,并将由网站维护者审查。
与内容更改相比,技术基础设施更改需要进行更多测试,以确保它们在 macOS 和 Linux(网站的主要开发环境)上都能正常工作。
信息设计、用户体验和用户界面设计治理
对网站样式的增量修复和改进通过提交拉取请求完成,并将由网站维护者审查。
对导航、用户体验和用户界面的较大更改需要与网站工作组协商,以决定适当的方法。此类更广泛的更改可以通过公共论坛帖子提出,也可以通过在 Swift 论坛上联系网站工作组 @swift-website-workgroup 私下提出建议。