From 68215323e5f728c77bc84af8c989bea42ccce5fd Mon Sep 17 00:00:00 2001
From: Joe Heck <j_heck@apple.com>
Date: Fri, 31 Jul 2026 16:35:37 -0700
Subject: [PATCH] adding a Windows platform collection

Adds a short placeholder landing page for the Windows platform,
pointing to swift.org's install instructions, with room to grow once
building/porting guidance for Windows is vetted.
---
 scripts/navigation.json                       |  3 ++-
 scripts/sources.json                          |  6 ++++++
 windows/Package.swift                         | 19 +++++++++++++++++++
 windows/Snippets/.gitkeep                     |  0
 .../SwiftWindows.docc/Documentation.md        | 15 +++++++++++++++
 windows/Sources/_empty.swift                  | 13 +++++++++++++
 6 files changed, 55 insertions(+), 1 deletion(-)
 create mode 100644 windows/Package.swift
 create mode 100644 windows/Snippets/.gitkeep
 create mode 100644 windows/Sources/SwiftWindows.docc/Documentation.md
 create mode 100644 windows/Sources/_empty.swift

diff --git a/scripts/navigation.json b/scripts/navigation.json
index fcfc59ab4..7aefea905 100644
--- a/scripts/navigation.json
+++ b/scripts/navigation.json
@@ -33,7 +33,8 @@
         { "source": "swift-android", "path": "/documentation/swiftandroid", "title": "Android" },
         { "source": "embedded-swift", "path": "/documentation/embeddedswift", "title": "Embedded Swift" },
         { "source": "swift-linux", "path": "/documentation/swiftlinux", "title": "Linux" },
-        { "source": "swift-wasm", "path": "/documentation/wasmguide", "title": "WebAssembly (Wasm)"}
+        { "source": "swift-wasm", "path": "/documentation/wasmguide", "title": "WebAssembly (Wasm)"},
+        { "source": "swift-windows", "path": "/documentation/swiftwindows", "title": "Windows" }
       ]
     },
     {
diff --git a/scripts/sources.json b/scripts/sources.json
index 154a730be..87ee422ff 100644
--- a/scripts/sources.json
+++ b/scripts/sources.json
@@ -77,6 +77,12 @@
       "path": "linux",
       "targets": ["SwiftLinux"]
     },
+    {
+      "id": "swift-windows",
+      "type": "local",
+      "path": "windows",
+      "targets": ["SwiftWindows"]
+    },
     {
       "id": "official-libraries",
       "type": "local",
diff --git a/windows/Package.swift b/windows/Package.swift
new file mode 100644
index 000000000..933c686be
--- /dev/null
+++ b/windows/Package.swift
@@ -0,0 +1,19 @@
+// swift-tools-version: 6.2
+
+import PackageDescription
+
+let package = Package(
+  name: "SwiftWindows",
+  products: [
+    .library(name: "SwiftWindows", targets: ["SwiftWindows"])
+  ],
+  dependencies: [
+    .package(url: "https://github.com/swiftlang/swift-docc-plugin", from: "1.1.0")
+  ],
+  targets: [
+    .target(
+      name: "SwiftWindows",
+      path: "Sources"
+    )
+  ]
+)
diff --git a/windows/Snippets/.gitkeep b/windows/Snippets/.gitkeep
new file mode 100644
index 000000000..e69de29bb
diff --git a/windows/Sources/SwiftWindows.docc/Documentation.md b/windows/Sources/SwiftWindows.docc/Documentation.md
new file mode 100644
index 000000000..edb09170a
--- /dev/null
+++ b/windows/Sources/SwiftWindows.docc/Documentation.md
@@ -0,0 +1,15 @@
+# ``SwiftWindows``
+
+Build and run Swift on Windows.
+
+@Metadata {
+    @DisplayName("Windows")
+    @TitleHeading("")
+}
+
+Swift supports native development on Windows, including a downloadable
+toolchain and integration with Visual Studio's build tools.
+
+Visit [Install Swift on Windows](https://www.swift.org/install/windows/) to
+get started. More guidance on building and porting packages to Windows is
+coming soon.
diff --git a/windows/Sources/_empty.swift b/windows/Sources/_empty.swift
new file mode 100644
index 000000000..1830a90de
--- /dev/null
+++ b/windows/Sources/_empty.swift
@@ -0,0 +1,13 @@
+//===----------------------------------------------------------------------===//
+//
+// This source file is part of the Swift.org open source project
+//
+// Copyright (c) 2026 Apple Inc. and the Swift.org project authors
+// Licensed under Apache License v2.0
+//
+// See LICENSE.txt for license information
+// See CONTRIBUTORS.txt for the list of Swift.org project authors
+//
+// SPDX-License-Identifier: Apache-2.0
+//
+//===----------------------------------------------------------------------===//