“Swift 编程语言” 书籍现已通过 DocC 发布

Alex Martini Alex Martini

我们很高兴地宣布，《Swift 编程语言》书籍 (TSPL) 现已开始使用 Swift-DocC 发布，从 Swift 5.8 开始。TSPL 现在准备好开始接受内容贡献，由 Swift 文档工作组指导。

本书迈出了重要一步。它于 2022 年 8 月首次开源发布，从那时起，在转换为 DocC 的过程中，我们合并了 50 多个 pull request。我们还根据在本书上的工作经验对 DocC 进行了增强，例如添加了对自动“另请参阅”部分和新的页面内导航的控制。其他引导开发者完成线性叙事的 DocC 内容，例如大型或复杂包的文档，也可以利用这些增强功能。

参与进来

为 TSPL 贡献内容。 关于您可以撰写的内容的一些想法，请参阅项目的 GitHub issues 页面 和最近接受的 Swift 演进提案。有关做出贡献的详细信息，请参阅 Git 存储库中的 CONTRIBUTING.md 文件，包括何时在 Swift 文档论坛类别中提出重大更改。

参与翻译项目。 TSPL 的 翻译 现在可以使用与英文版 TSPL 相同的发布流程。翻译贡献者可以通过关注 Swift 论坛上的 pitch 帖子和 GitHub 中的 pull request 来跟踪英文版本的更改。

改进 DocC 对长篇内容的支持。 还有更多机会为改进的文档体验做出贡献，例如添加对交互式和离线内容的支持，以及对经过测试的代码列表的支持。有关更多想法，请参阅 TSPL 和 DocC 的 GitHub issues 页面。