We’re happy to announce that "The Swift Programming Language" book is now an open source project. This new project will be the basis of publishing the book on Swift.org in the future (more details below), and will use the open source DocC tool. We’re excited to work with the Documentation Workgroup to take the project forward.
We ask that you try building the repository locally with DocC, and file issues you may encounter when compiling, editing, or reading the book. We’ll be adding some initial issues to the book’s GitHub repository, and feel free to add your own. Until this open version is ready to take over, the book published on Swift.org will be generated using Apple’s internal toolchain.
For now, we're expecting most pull requests to be enhancements and bug fixes to support the Swift-DocC publication, with only minor content changes. When the open source repository is able to generate a high-quality version of TSPL, we will switch over to publishing directly from that repository. At that time we'll also start taking pull requests for more content changes.
An open source TSPL is finally possible because of Swift-DocC, a great open source documentation tool well suited to author, maintain, and publish the Swift book. With snippets support, it will also be possible to move inline example code over to buildable sample programs stored in the repository. This is a really exciting time for Swift documentation, and we can’t wait to see how the book evolves with help from so many more enthusiastic developers.