From 5a1143947f21c5b1662427718b925a8f79d904a2 Mon Sep 17 00:00:00 2001 From: Joe Heck Date: Thu, 7 Aug 2025 15:39:51 -0700 Subject: [PATCH 1/2] initial, simple SDK documentation --- .../Documentation.docc/SwiftSDKCommands.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/Sources/PackageManagerDocs/Documentation.docc/SwiftSDKCommands.md b/Sources/PackageManagerDocs/Documentation.docc/SwiftSDKCommands.md index 5c8f695cd3c..d9f0ec7a363 100644 --- a/Sources/PackageManagerDocs/Documentation.docc/SwiftSDKCommands.md +++ b/Sources/PackageManagerDocs/Documentation.docc/SwiftSDKCommands.md @@ -9,9 +9,15 @@ Perform operations on Swift SDKs. ## Overview -Overview of package manager commands here... +By default, Swift Package Manager compiles code for the host platform on which you run it. +Swift 6.1 introduced SDKs to support cross-compilation. - +SDKs are tightly coupled with the toolchain used to create them. +Supported SDKs are distributed by the Swift project with links on the [installation page](https://www.swift.org/install/) for macOS and Linux, and included in the distribution for Windows. + +Additionally, the Swift project provides a tooling repository called [swift-sdk-generator](https://github.com/swiftlang/swift-sdk-generator) that you can use to create a custom SDK for your preferred platform. + +For more information on the introduction of Swift SDKs, refer to the Swift evolution proposal [SE-0387](https://github.com/swiftlang/swift-evolution/blob/main/proposals/0387-cross-compilation-destinations.md). ## Topics From bb18313af88af13e6c8997e3eecdb24f839998e1 Mon Sep 17 00:00:00 2001 From: Joe Heck Date: Mon, 11 Aug 2025 10:37:35 -0700 Subject: [PATCH 2/2] embedding link to proposal in overview, but not referencing it for more information --- .../Documentation.docc/SwiftSDKCommands.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/Sources/PackageManagerDocs/Documentation.docc/SwiftSDKCommands.md b/Sources/PackageManagerDocs/Documentation.docc/SwiftSDKCommands.md index d9f0ec7a363..ac930046468 100644 --- a/Sources/PackageManagerDocs/Documentation.docc/SwiftSDKCommands.md +++ b/Sources/PackageManagerDocs/Documentation.docc/SwiftSDKCommands.md @@ -10,14 +10,14 @@ Perform operations on Swift SDKs. ## Overview By default, Swift Package Manager compiles code for the host platform on which you run it. -Swift 6.1 introduced SDKs to support cross-compilation. +Swift 6.1 introduced SDKs (through +[SE-0387](https://github.com/swiftlang/swift-evolution/blob/main/proposals/0387-cross-compilation-destinations.md)) +to support cross-compilation. SDKs are tightly coupled with the toolchain used to create them. Supported SDKs are distributed by the Swift project with links on the [installation page](https://www.swift.org/install/) for macOS and Linux, and included in the distribution for Windows. -Additionally, the Swift project provides a tooling repository called [swift-sdk-generator](https://github.com/swiftlang/swift-sdk-generator) that you can use to create a custom SDK for your preferred platform. - -For more information on the introduction of Swift SDKs, refer to the Swift evolution proposal [SE-0387](https://github.com/swiftlang/swift-evolution/blob/main/proposals/0387-cross-compilation-destinations.md). +Additionally, the Swift project provides the tooling repository [swift-sdk-generator](https://github.com/swiftlang/swift-sdk-generator) that you can use to create a custom SDK for your preferred platform. ## Topics