Skip to content

Add a shared platform support pattern to Apple platforms, Linux, and Windows - #132

Open
heckj wants to merge 2 commits into
swiftlang:mainfrom
heckj:platform-support-pattern
Open

Add a shared platform support pattern to Apple platforms, Linux, and Windows#132
heckj wants to merge 2 commits into
swiftlang:mainfrom
heckj:platform-support-pattern

Conversation

@heckj

@heckj heckj commented Aug 6, 2026

Copy link
Copy Markdown
Member

Summary

  • Adds a ### Platform support subsection to each of apple-platforms/, linux/, and windows/'s Documentation.md, following one shared shape: an SP-0001 tier statement, a minimum version/architecture table, an available-tools note, a platform-owner note, and a closing link to https://www.swift.org/platform-support/ for the full cross-platform comparison.
  • None of these three catalogs currently say anything about supported versions, tools, or ownership inside the combined docs build — this fills that gap without duplicating the full multi-platform matrix that already lives on swift.org.
  • No changes to scripts/sources.json or scripts/navigation.json; the existing three-catalog wiring under the "Platforms" nav group is unchanged.

Test plan

  • swift package generate-documentation --analyze --warnings-as-errors passes in apple-platforms/, linux/, and windows/
  • Version/tool facts cross-checked against the live https://www.swift.org/platform-support/ page
  • Visually confirm rendering via swift package --disable-sandbox preview-documentation in each catalog

…Windows

Each catalog now states its SP-0001 tier, minimum supported
versions/architectures, available tools, and platform owner, then links
out to swift.org/platform-support for the full cross-platform comparison.
@heckj
heckj requested a review from shahmishal August 7, 2026 16:44
@heckj heckj self-assigned this Aug 7, 2026
@heckj
heckj requested a review from davelester August 7, 2026 16:44
@heckj

heckj commented Aug 7, 2026

Copy link
Copy Markdown
Member Author

Adding what this looks in the Apple, Linux, and Windows platform pages rendered locally

Apple:

apple

Windows:

win

Linux:

linux

Comment thread linux/Sources/SwiftLinux.docc/Documentation.md Outdated
Co-authored-by: Mishal Shah <mishal_shah@apple.com>
@heckj
heckj requested a review from a team August 25, 2026 20:36
and a toolchain host — the Swift compiler, Swift Package Manager, and
SourceKit-LSP all run natively on Windows 10.0 and later.

The LLDB debugger is available on Windows, but the Swift REPL isn't

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Turns out that this is no longer accurate 😅 We have actually managed to get the REPL working and Charles (Zablit) has managed to fix a few LLDB issues that fixed the last few issues I believe.

@finagolfin

Copy link
Copy Markdown
Member

Will Android's status be added to this list on the website somewhere? The Android workgroup submitted our application in January and were told our status was approved soon after, with that to be published on the website sometime later.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants