Skip to content

initial, simple SDK documentation #9004

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

heckj
Copy link
Member

@heckj heckj commented Aug 7, 2025

Provides some basic detail for Swift cross-compilation SDKs, referencing the installation links on swift.org, the evolution proposal, and the SDK generator code.

resolves #8864, to finalize the documentation of the CLI commands

@heckj
Copy link
Member Author

heckj commented Aug 7, 2025

@swift-ci please test

@bripeticca
Copy link
Contributor

@swift-ci please test 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).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure linking to SE proposals as documentation is the best idea as a form of documentation, since they can become stale over time or be lacking in details we want to communicate. This seems like a good addition for now, although as a follow-on I think we should probably say something more like "was introduced in SE-0387" (with the link), but then go on to repeat the relevant parts here in detail along with any additional information we want to communicate.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Add documentation in SwiftPM for using SDKs
3 participants