Merge branch 'swiftlang:main' into main

marcprux · web-flow · commit 0021d38971bc · 2025-06-05T12:08:23.000-04:00
diff --git a/404.md b/404.md
@@ -4,7 +4,9 @@ title: Internal Server Error
 permalink: /404.html
 ---
 
-<section class="section">
-    <h1>Not Found</h1>
-    The page you're looking for can’t be found.
+<section id="exception">
+    <div class="content">
+        <h1>Not Found</h1>
+        <p>The page you're looking for can’t be found.</p>
+    </div>
 </section>
diff --git a/_data/documentation.yaml b/_data/documentation.yaml
@@ -39,10 +39,6 @@
     url: /documentation/server/
     description: |
       Swift is a general-purpose programming language with unique characteristics that make it specifically suitable for Server applications.
-  - title: Embedded development
-    url: /getting-started/embedded-swift/
-    description: |
-      Introduction to embedded development using Swift. Learn how to get started.
   - title: Mixing Swift and C++
     url: /documentation/cxx-interop/
     description: |
diff --git a/_data/new-data/get-started/embedded/link-columns.yml b/_data/new-data/get-started/embedded/link-columns.yml
@@ -9,7 +9,7 @@ columns:
       - text: Embedded Swift vision document
         url: 'https://github.com/swiftlang/swift-evolution/blob/main/visions/embedded-swift.md'
       - text: Embedded Swift example projects
-        url: 'https://github.com/apple/swift-embedded-examples'
+        url: 'https://github.com/swiftlang/swift-embedded-examples'
   - headline: Talks
     links:
       - text: Go Small With Embedded Swift
diff --git a/_data/new-data/get-started/embedded/primary-content.yml b/_data/new-data/get-started/embedded/primary-content.yml
@@ -5,13 +5,13 @@ primary_cards:
     logo_alt: Harmony
     text: Build a Bluetooth speaker with a ferrofluid visualizer using the Raspberry Pi Pico W.
     link_text: Learn more
-    link: https://github.com/apple/swift-embedded-examples/tree/main/harmony
+    link: https://github.com/swiftlang/swift-embedded-examples/tree/main/harmony
 
   - name: Matter and HomeKit Smart Light
     logo: /assets/images/get-started/matter-homeKit-smartlight@2x.png
     logo_alt: Matter and HomeKit Smart Light
     text: Implement a Matter smart light accessory that can be used from HomeKit, using an ESP32 microcontroller.
-    link: https://github.com/apple/swift-matter-examples
+    link: https://github.com/swiftlang/swift-matter-examples
     link_text: Learn more
 
 secondary_cards:
@@ -20,7 +20,7 @@ secondary_cards:
     logo: /assets/images/get-started/interactive-ui-examples@2x.png
     text: Build projects using the popular embedded graphics library LVGL on an STM32 board for rich UI and touch input.
     link_text: Learn more
-    link: https://github.com/apple/swift-embedded-examples/tree/main/stm32-lvgl
+    link: https://github.com/swiftlang/swift-embedded-examples/tree/main/stm32-lvgl
 
   - name: PlaydateKit
     logo: /assets/images/get-started/playdate-kit@2x.png
@@ -30,5 +30,5 @@ secondary_cards:
     link_text: Learn more
 
 link:
-  url: https://github.com/apple/swift-embedded-examples
+  url: https://github.com/swiftlang/swift-embedded-examples
   text: Explore more Embedded Swift examples and templates on Github
diff --git a/_posts/2024-03-12-byte-sized-swift-tiny-games-playdate.md b/_posts/2024-03-12-byte-sized-swift-tiny-games-playdate.md
@@ -6,7 +6,7 @@ title: "Byte-sized Swift: Building Tiny Games for the Playdate"
 author: [rauhul]
 ---
 
-I'm excited to share [swift-playdate-examples](https://github.com/apple/swift-playdate-examples), a technical demonstration of using Swift to build games for [Playdate](https://play.date/), a handheld game system by [Panic](https://panic.com).
+I'm excited to share [swift-playdate-examples](https://github.com/swiftlang/swift-playdate-examples), a technical demonstration of using Swift to build games for [Playdate](https://play.date/), a handheld game system by [Panic](https://panic.com).
 
 <video title="A screencapture of Swift Break running on Playdate hardware mirrored to a Mac." autoplay loop muted style="width: 100%; border-radius: 15px;">
   <source src="{{site.url}}/assets/images/2024-03-12-byte-sized-swift-tiny-games-playdate/playdate-mirror-video-swiftbreak.mp4" type="video/mp4">
@@ -96,7 +96,7 @@ Swift Break features a splash screen, a pause menu, paddle-location-based bounce
 
 ## Try it Out
 
-If you're eager to use Swift on your Playdate, the [swift-playdate-examples](https://github.com/apple/swift-playdate-examples) repository has you covered. It contains the above ready-to-use examples that demonstrate how to build Swift games for the Playdate, both for the simulator and the hardware.
+If you're eager to use Swift on your Playdate, the [swift-playdate-examples](https://github.com/swiftlang/swift-playdate-examples) repository has you covered. It contains the above ready-to-use examples that demonstrate how to build Swift games for the Playdate, both for the simulator and the hardware.
 
 Additionally, the repository includes detailed documentation to guide you through the setup process. Whether you're a seasoned developer or just starting, you'll find the necessary resources to bring your ideas to life.
 
@@ -440,7 +440,7 @@ Thanks for diving into the bring-up journey with me. From refining the Swift Pla
 
 However, with the issues now resolved, creating Playdate games in Swift is a streamlined process. Just run `make` and enjoy a development experience with Swift that is both expressive _and_ performant.
 
-You can find all the code examples mentioned in this post in the [swift-playdate-examples](https://github.com/apple/swift-playdate-examples) repository with accompanying "Getting Started" documentation.
+You can find all the code examples mentioned in this post in the [swift-playdate-examples](https://github.com/swiftlang/swift-playdate-examples) repository with accompanying "Getting Started" documentation.
 
 I hope this post encourages you to explore the possibilities of using Swift in unconventional environments. Feel free to reach out with your experiences, questions, or game ideas on the [Swift Forums](https://forums.swift.org/t/byte-sized-swift-building-tiny-games-for-the-playdate/70615)!
 
diff --git a/_posts/2024-04-03-embedded-swift-examples.md b/_posts/2024-04-03-embedded-swift-examples.md
@@ -6,13 +6,13 @@ title: "Get Started with Embedded Swift on ARM and RISC-V Microcontrollers"
 author: [kubamracek]
 ---
 
-We're pleased to introduce a [repository of example projects](https://github.com/apple/swift-embedded-examples) that demonstrate how Embedded Swift can be used to develop software on a range of microcontrollers.
+We're pleased to introduce a [repository of example projects](https://github.com/swiftlang/swift-embedded-examples) that demonstrate how Embedded Swift can be used to develop software on a range of microcontrollers.
 
 Swift is a scalable language, great for writing desktop and mobile apps, server backends, and system software. And as you [may have seen](https://www.swift.org/blog/byte-sized-swift-tiny-games-playdate/), thanks to a new, experimental compilation mode, you can use Swift to target embedded environments like ARM and RISC-V microcontrollers as well, popular for building professional and hobbyist electronics projects such as IoT devices.
 
 Microcontrollers are constrained environments where not all of Swift’s features are appropriate. The new Embedded Swift compilation mode turns off certain language features like runtime reflection, ABI stability, and existentials, to produce standalone binaries suitable for firmware. Despite turning off some language features, the Embedded Swift subset still feels very close to the “full” Swift that developers love, and makes it easy to continue writing idiomatic, easy-to-read Swift code. You can dive into the details in the formally accepted [Embedded Swift Vision Document](https://github.com/swiftlang/swift-evolution/blob/main/visions/embedded-swift.md), and try it out in the [nightly downloadable toolchains](https://www.swift.org/download/#snapshots).
 
-The Swift community has already started publishing [several](https://forums.swift.org/t/embedded-swift-on-the-raspberry-pi-pico-rp2040-without-the-pico-sdk/69338) [fascinating](https://forums.swift.org/t/rp2040mmio-a-hardware-access-layer-for-the-rp2040/69513/1) [projects](https://forums.swift.org/t/byte-sized-swift-building-tiny-games-for-the-playdate/70615) built with this language mode, and we thought it would be useful to publish a collection of sample projects at [**swift-embedded-examples**](https://github.com/apple/swift-embedded-examples).
+The Swift community has already started publishing [several](https://forums.swift.org/t/embedded-swift-on-the-raspberry-pi-pico-rp2040-without-the-pico-sdk/69338) [fascinating](https://forums.swift.org/t/rp2040mmio-a-hardware-access-layer-for-the-rp2040/69513/1) [projects](https://forums.swift.org/t/byte-sized-swift-building-tiny-games-for-the-playdate/70615) built with this language mode, and we thought it would be useful to publish a collection of sample projects at [**swift-embedded-examples**](https://github.com/swiftlang/swift-embedded-examples).
 
 <div align="center" style="padding: 0 0 20px 0;"><i>
 <img src="/assets/images/embedded-examples/boards.jpg" alt="Swift on STM32F746, Raspberry Pi Pico, nRF52840, and ESP32C6">
@@ -26,7 +26,7 @@ We encourage anyone interested to try out the examples and help us grow the repo
 
 ## Try It Out
 
-If you'd like to try out the existing example projects, visit the repository at [**swift-embedded-examples**](https://github.com/apple/swift-embedded-examples). It contains a catalog of examples along with instructions on how to build and run each of them.
+If you'd like to try out the existing example projects, visit the repository at [**swift-embedded-examples**](https://github.com/swiftlang/swift-embedded-examples). It contains a catalog of examples along with instructions on how to build and run each of them.
 
 To use these examples, be sure to install the latest [development snapshot toolchain](https://www.swift.org/download/#snapshots). As an experimental mode, Embedded Swift is not yet available in release versions of Swift.
 
diff --git a/_posts/2025-06-02-swift-at-apple-migrating-the-password-monitoring-service-from-java.md b/_posts/2025-06-02-swift-at-apple-migrating-the-password-monitoring-service-from-java.md
@@ -2,7 +2,7 @@
 layout: post
 published: true
 date: 2025-06-02 10:00:00
-title: "Swift at Apple: migrating the Password Monitoring service from Java"
+title: "Swift at Apple: Migrating the Password Monitoring service from Java"
 author: [rmondello, indravardhan, spencervd6, umeshbatra13]
 ---
 
diff --git a/assets/stylesheets/_screen.scss b/assets/stylesheets/_screen.scss
@@ -178,6 +178,8 @@ cite {
 }
 
 .header-with-anchor {
+  scroll-margin-top: 80px;
+
   a {
     display: none;
     color: var(--color-text);
diff --git a/assets/stylesheets/new-stylesheets/_helpers.scss b/assets/stylesheets/new-stylesheets/_helpers.scss
@@ -194,3 +194,9 @@
     white-space: normal;
   }
 }
+
+@mixin underline {
+  text-decoration: underline;
+  text-decoration-color: color-mix(in srgb, currentColor 50%, transparent);
+  text-underline-offset: 2px;
+}
diff --git a/assets/stylesheets/new-stylesheets/_pages.scss b/assets/stylesheets/new-stylesheets/_pages.scss
@@ -1,3 +1,4 @@
 @use 'pages/index';
+@use 'pages/exception';
 @use 'pages/install';
 @use 'pages/get-started';
diff --git a/assets/stylesheets/new-stylesheets/_themes.scss b/assets/stylesheets/new-stylesheets/_themes.scss
@@ -22,6 +22,8 @@
 
   --page-bg: #fff;
 
+  --exception-page-bg: #fac685;
+
   --install-page-bg: linear-gradient(0deg, #f6b391 0%, #f8ce6e 92%);
   --install-site-code-box-bg: #ffffff;
   --install-site-code-box-pre-bg: #f2f2f2;
@@ -124,6 +126,8 @@
 
   --page-bg: #fff;
 
+  --exception-page-bg: #23344a;
+
   --install-page-bg: linear-gradient(0deg, #ff8115 0%, #b7451b 92%);
   --install-site-code-box-bg: #23344a;
   --install-site-code-box-pre-bg: #111727;
diff --git a/assets/stylesheets/new-stylesheets/includes/callout/_base.scss b/assets/stylesheets/new-stylesheets/includes/callout/_base.scss
@@ -37,9 +37,7 @@
       @include link-with-right-arrow();
       display: block;
       color: white;
-      text-decoration: underline;
-      text-decoration-color: rgba(255, 255, 255, 0.5);
-      text-underline-offset: 2px;
+      @include underline;
       margin-top: 14px;
 
       i {
diff --git a/assets/stylesheets/new-stylesheets/pages/_exception.scss b/assets/stylesheets/new-stylesheets/pages/_exception.scss
@@ -0,0 +1,22 @@
+#exception {
+  display: flex;
+  flex-direction: column;
+  background-color: var(--exception-page-bg);
+  color: var(--site-text-color);
+
+  .content {
+    flex-grow: 1;
+    display: flex;
+    flex-direction: column;
+    text-align: center;
+    padding: 18vw 0;
+
+    h1 {
+      font-size: 48px;
+    }
+
+    @media only screen and (max-width: 1024px) {
+      margin: 90px 0;
+    }
+  }
+}
diff --git a/assets/stylesheets/new-stylesheets/pages/_get-started.scss b/assets/stylesheets/new-stylesheets/pages/_get-started.scss
@@ -554,9 +554,10 @@
 
   @media only screen and (max-width: 768px) {
     nav {
+     width: 100%;
+
       ul {
         white-space: nowrap;
-        width: calc(100% - 59px);
       }
     }
   }
diff --git a/assets/stylesheets/new-stylesheets/pages/_install.scss b/assets/stylesheets/new-stylesheets/pages/_install.scss
@@ -49,7 +49,7 @@
           @include link-with-right-arrow;
           margin-top: 10px;
           display: flex;
-          text-decoration: underline;
+          @include underline;
 
           &.block {
             justify-content: center;
diff --git a/get-started/embedded/index.md b/get-started/embedded/index.md
@@ -1,4 +1,5 @@
 ---
+redirect_from: "getting-started/embedded-swift"
 layout: new-layouts/base
 title: Embedded
 ---
diff --git a/getting-started/_use-cases.md b/getting-started/_use-cases.md
@@ -55,17 +55,6 @@ Here are some examples of the many use cases of Swift, in case you want to jump
 
     <a href="/getting-started/swiftui" class="cta-secondary">Start tutorial</a>
   </li>
-
-  <li class="grid-level-1">
-    <h3>Embedded Application for a Microcontroller</h3>
-    <p class="description">
-      Learn how to create an application using Embedded Swift that will run on an embedded device or in a simulator.
-      <br><br>
-      This guide requires macOS or Linux.
-    </p>
-
-    <a href="/getting-started/embedded-swift" class="cta-secondary">Start tutorial</a>
-  </li>
 </ul>
 
 ---
diff --git a/getting-started/embedded-swift/index.md b/getting-started/embedded-swift/index.md

Original file line number	Diff line number	Diff line change
`@@ -178,6 +178,8 @@ cite {`
`178`	`178`	`}`
`179`	`179`
`180`	`180`	`.header-with-anchor {`
	`181`	`+ scroll-margin-top: 80px;`
	`182`	`+`
`181`	`183`	`a {`
`182`	`184`	`display: none;`
`183`	`185`	`color: var(--color-text);`
Original file line number	Diff line number	Diff line change
`@@ -194,3 +194,9 @@`
`194`	`194`	`white-space: normal;`
`195`	`195`	`}`
`196`	`196`	`}`
	`197`	`+`
	`198`	`+@mixin underline {`
	`199`	`+ text-decoration: underline;`
	`200`	`+ text-decoration-color: color-mix(in srgb, currentColor 50%, transparent);`
	`201`	`+ text-underline-offset: 2px;`
	`202`	`+}`