[6.4] Docs: Add 6.4 release notes and other changes by bkhouri · Pull Request #9851 · swiftlang/swift-package-manager

bkhouri · 2026-03-25T18:10:42Z

Update the SwiftPM documentation to include 6.4 release notes.

Also, move the Release notes from previous released over to the official documentation target

Fixes: #9281
Issue: rdar://171094628
Issue: rdar://163263361

Linked PR: swiftlang/swift-org-website#1390

A PR in Swift Package Manager makes a change that will cause a link in the "Swift 6.3 Released" blog post to be broken. Update the URL to the correct location. Depeneds on: swiftlang/swift-package-manager#9851

A PR in Swift Package Manager makes a change that will cause a link in the "Swift 6.3 Released" blog post to be broken. Update the URL to the correct location. Relates to: swiftlang/swift-package-manager#9851

A PR in Swift Package Manager makes a change that will cause a link in the "Swift 6.3 Released" blog post to be broken. Update the URL to the correct location. Depends on: swiftlang/swift-package-manager#9851

jakepetroules · 2026-04-15T22:55:07Z

+Understand and use the next-generation build system for Package Manager.
+
+@Metadata {
+    @Available("Swift", introduced: "6.3")


I'm not sure. SwiftBuild was introduced in 6.3. I'm not sure what this metadata tag does.

@heckj: Any thoughts on what the value should be here?

heckj · 2026-04-21T15:27:10Z

 ### Guides

+- <doc:SwiftBuildDefault>
 - <doc:SwiftBuildPreview>


we'll likely want to strip out the SwiftBuildPreview when we have SwiftBuildDefault ;-)

heckj · 2026-04-21T15:44:18Z

+
+We encourage you to [use](#How-to-use-the-Swift-Build-build-system) the build system in your project and [report any issues](#Reporting-issues) you encounter.
+
+For more information about the migration to Swift Build, see [Evolving SwiftPM buildswith Swift Build](https://forums.swift.org/t/evolving-swiftpm-builds-with-swift-build/77596) on the [Swift Forums](https://forums.swift.org).


The framing on this doc is a mixture of upsell, migration information content, and gaps - and it feels more like a blog post (a point in time status update kind of thing) that documentation that's expected to be consistent and live for an extended period.

We should find and pull up any content from the forums that are linked above rather than directing someone into the forums for that information. This should (ideally) be the refinement of what the migration process it, and it's what I expected I might find based on the title.

There's a little bit of awkward framing as "native" vs. "next generation" that's also very point-in-time focused. If there's something you need to do differently to build a swift package with the new swift-build as a default - then we should be updating that docs kind of across the board where-ever that's relevant, and I'd suggest framing this article as a migration guide - if we need one.

For the known issues and gaps, and reporting issues, I'd keep all of that entirely with the release notes article. The earlier analog to this was "here's a preview, please try it", but with that complete any docs content should be focused more on "here's how it works" vs. "here's what's new". The "here's what's new" is exactly what release notes are good at, as they're expected to be reflecting a specific point in time.

heckj · 2026-04-21T15:50:36Z

 - <doc:GettingStarted>
 - <doc:IntroducingPackages>
 - <doc:PackageSecurity>
+- <doc:ReleaseNotes>


I'd recommend pushing this entry to the very bottom of the page - ideally it's not something that we expect folks to be needing for day to day Q&A about SwiftPM, and if they do - they'll look for it

Update the SwiftPM documentation to include 6.4 release notes. Also, move the Release notes from previous released over to the official documentation target Fixes: swiftlang#9281 Issue: rdar://171094628 Issue: rdar://163263361

bkhouri · 2026-05-14T13:01:10Z

@swift-ci test

bkhouri changed the title ~~Docs: Add 6.4 release notes~~ Docs: Add 6.4 release notes and other changes Mar 25, 2026

bkhouri force-pushed the t/main/rdar171094628_document_swiftbuild_6.4_replatform branch from 045dc96 to 2283da6 Compare March 26, 2026 13:11

bkhouri force-pushed the t/main/rdar171094628_document_swiftbuild_6.4_replatform branch from 2283da6 to b008e76 Compare April 7, 2026 14:57

bkhouri mentioned this pull request Apr 9, 2026

Update link in Swift 6.3 blog post swiftlang/swift-org-website#1390

Draft

bkhouri force-pushed the t/main/rdar171094628_document_swiftbuild_6.4_replatform branch 3 times, most recently from 406e9ed to 4ae010c Compare April 15, 2026 18:07