# Moving "The Swift Programming Language" book to open source

**URL:** <https://forums.swift.org/t/moving-the-swift-programming-language-book-to-open-source/59989>\
**Category:** Announcements\
**Tags:** documentation\
**Created:** [August 30, 2022, 5:08pm UTC](https://forums.swift.org/t/moving-the-swift-programming-language-book-to-open-source/59989 "2022-08-30T17:08:53Z")\
**Posts on this page:** 10\
**Page:** 1

<div class="post-metadata">

**Author:** ![krilnon](https://sea2.discourse-cdn.com/swift/user_avatar/forums.swift.org/krilnon/32/276_2.png) [@krilnon](https://forums.swift.org/u/krilnon)\
**Post date:** [August 30, 2022, 5:08pm UTC](https://forums.swift.org/t/moving-the-swift-programming-language-book-to-open-source/59989/1 "2022-08-30T17:08:53Z")

</div>

We’re happy to announce that "The Swift Programming Language" book is now an [open source project](https://github.com/apple/swift-book). This new project will be the basis of publishing the book on [Swift.org](https://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](https://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](https://github.com/apple/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.

---

<div class="post-metadata">

**Author:** ![franklin](https://sea2.discourse-cdn.com/swift/user_avatar/forums.swift.org/franklin/32/17924_2.png) [@franklin](https://forums.swift.org/u/franklin)\
**Post date:** [August 30, 2022, 5:17pm UTC](https://forums.swift.org/t/moving-the-swift-programming-language-book-to-open-source/59989/2 "2022-08-30T17:17:05Z")

</div>

Congrats Kyle and team! 🎉 The [@swift-documentation-workgroup](https://forums.swift.org/groups/swift-documentation-workgroup) is super excited to be part of the project's evolution and improve DocC alongside it to make learning Swift more accessible to everyone!

---

<div class="post-metadata">

**Author:** ![marcusziade](https://sea2.discourse-cdn.com/swift/user_avatar/forums.swift.org/marcusziade/32/30796_2.png) [@marcusziade](https://forums.swift.org/u/marcusziade)\
**Post date:** [August 30, 2022, 6:52pm UTC](https://forums.swift.org/t/moving-the-swift-programming-language-book-to-open-source/59989/3 "2022-08-30T18:52:06Z")

</div>

Very cool. Looking forward to contribute

---

<div class="post-metadata">

**Author:** ![Sajjon](https://sea2.discourse-cdn.com/swift/user_avatar/forums.swift.org/sajjon/32/12044_2.png) [@Sajjon](https://forums.swift.org/u/Sajjon)\
**Post date:** [August 30, 2022, 7:17pm UTC](https://forums.swift.org/t/moving-the-swift-programming-language-book-to-open-source/59989/4 "2022-08-30T19:17:34Z")

</div>

I've made some PRs already, but wanted to ask for feedback here on Swift Forums, I've created a [PR which proposes to change 'Swift is a new programming language' to just 'Swift is a programming language'](https://github.com/apple/swift-book/pull/14), do you agree? Time for Swift to graduate! 🎓🎉

I've also made [a comment about maybe mentioning what Swift can be used for, which currently only lists Apple app development](https://github.com/apple/swift-book/pull/14#issuecomment-1232034180), shouldn't Unix and Windows be mentioned too?

---

<div class="post-metadata">

**Author:** ![Gavin\_Eadie](https://sea2.discourse-cdn.com/swift/user_avatar/forums.swift.org/gavin_eadie/32/40830_2.png) [@Gavin\_Eadie](https://forums.swift.org/u/Gavin_Eadie)\
**Post date:** [August 30, 2022, 10:31pm UTC](https://forums.swift.org/t/moving-the-swift-programming-language-book-to-open-source/59989/5 "2022-08-30T22:31:33Z")

</div>

Wow! Very, very cool! Kudos to all involved ..

---

<div class="post-metadata">

**Author:** ![hgbart](https://avatars.discourse-cdn.com/v4/letter/h/4af34b/32.png) [@hgbart](https://forums.swift.org/u/hgbart)\
**Post date:** [August 31, 2022, 6:01am UTC](https://forums.swift.org/t/moving-the-swift-programming-language-book-to-open-source/59989/6 "2022-08-31T06:01:05Z")

</div>

will there be a pdf version?

---

<div class="post-metadata">

**Author:** ![killobatt](https://sea2.discourse-cdn.com/swift/user_avatar/forums.swift.org/killobatt/32/25040_2.png) [@killobatt](https://forums.swift.org/u/killobatt)\
**Post date:** [August 31, 2022, 6:10am UTC](https://forums.swift.org/t/moving-the-swift-programming-language-book-to-open-source/59989/7 "2022-08-31T06:10:07Z")

</div>

Wow, this is super helpful for the translators!

When I started Ukrainian translation, I spent days just extracting text from epub and formatting it with markdown. Now you can just fork it.

And tracking updates will be much easier as well. Thanks a lot!

---

<div class="post-metadata">

**Author:** ![Alex\_Martini](https://sea2.discourse-cdn.com/swift/user_avatar/forums.swift.org/alex_martini/32/1383_2.png) [@Alex\_Martini](https://forums.swift.org/u/Alex_Martini)\
**Post date:** [August 31, 2022, 6:25pm UTC](https://forums.swift.org/t/moving-the-swift-programming-language-book-to-open-source/59989/8 "2022-08-31T18:25:23Z")

</div>

[Issue #2](https://github.com/apple/swift-book/issues/2) in the GitHub repository is tracking support for ePUB, PDF, or other offline forms.

---

<div class="post-metadata">

**Author:** ![azataiot](https://sea2.discourse-cdn.com/swift/user_avatar/forums.swift.org/azataiot/32/25110_2.png) [@azataiot](https://forums.swift.org/u/azataiot)\
**Post date:** [September 5, 2022, 3:55pm UTC](https://forums.swift.org/t/moving-the-swift-programming-language-book-to-open-source/59989/9 "2022-09-05T15:55:24Z")

</div>

How can i have multiple swift versions installed and defined for specific projects relatively ?

As when i am building the repo, i got this error as "'swift-book': error: package 'swift-book' is using Swift tools version 5.7.0 but the installed version is 5.6.0"

---

<div class="post-metadata">

**Author:** ![Sajjon](https://sea2.discourse-cdn.com/swift/user_avatar/forums.swift.org/sajjon/32/12044_2.png) [@Sajjon](https://forums.swift.org/u/Sajjon)\
**Post date:** [October 5, 2022, 6:05pm UTC](https://forums.swift.org/t/moving-the-swift-programming-language-book-to-open-source/59989/10 "2022-10-05T18:05:43Z")

</div>

Swift just graduated from school:

> <https://github.com/apple/swift-book/pull/14>
>
> I would argue that Swift is not \*new\* any more, it is a mature language at this …point and the first sentence of \`The Basics\` of Swift ought to reflect that 🎓🎉

🥳👩‍🎓
