From 2bfb7ab8614b0287cf81db7b6beb4c539f11c4b8 Mon Sep 17 00:00:00 2001
From: Stuart Montgomery <smontgomery@apple.com>
Date: Fri, 12 Sep 2025 14:02:08 -0500
Subject: [PATCH 1/4] Enable the Docs soundness check

---
 .github/workflows/pull_request.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/pull_request.yml b/.github/workflows/pull_request.yml
index bb435c6b4..6639ec3ec 100644
--- a/.github/workflows/pull_request.yml
+++ b/.github/workflows/pull_request.yml
@@ -23,6 +23,6 @@ jobs:
     uses: swiftlang/github-workflows/.github/workflows/soundness.yml@main
     with:
       license_header_check_project_name: "Swift"
-      docs_check_enabled: false
+      docs_check_container_image: "swiftlang/swift:nightly-6.2-noble"
       format_check_enabled: false
       api_breakage_check_enabled: false

From 4b536b767d2a1a98d5cd97d89b6bc5525d485d59 Mon Sep 17 00:00:00 2001
From: Stuart Montgomery <smontgomery@apple.com>
Date: Tue, 16 Sep 2025 16:25:45 -0500
Subject: [PATCH 2/4] Fix issues

---
 Sources/Testing/Testing.docc/Documentation.md       | 4 ++--
 Sources/Testing/Testing.docc/MigratingFromXCTest.md | 8 +++++---
 2 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/Sources/Testing/Testing.docc/Documentation.md b/Sources/Testing/Testing.docc/Documentation.md
index cc4001889..d77583c0d 100644
--- a/Sources/Testing/Testing.docc/Documentation.md
+++ b/Sources/Testing/Testing.docc/Documentation.md
@@ -36,8 +36,8 @@ their problems.
 #### Related videos
 
 @Links(visualStyle: compactGrid) {
-  - <doc://com.apple.documentation/videos/play/wwdc2024/10179>
-  - <doc://com.apple.documentation/videos/play/wwdc2024/10195>
+  - https://developer.apple.com/videos/play/wwdc2024/10179
+  - https://developer.apple.com/videos/play/wwdc2024/10195
 }
 
 ## Topics
diff --git a/Sources/Testing/Testing.docc/MigratingFromXCTest.md b/Sources/Testing/Testing.docc/MigratingFromXCTest.md
index fcf1f529d..6b1d9f381 100644
--- a/Sources/Testing/Testing.docc/MigratingFromXCTest.md
+++ b/Sources/Testing/Testing.docc/MigratingFromXCTest.md
@@ -556,9 +556,11 @@ test function with an instance of this trait type to control whether it runs:
   }
 }
 
-<!-- TODO: document Test.cancel() and Test.Case.cancel() here
+<!-- TODO: document Test.cancel() and Test.Case.cancel() here, and update
+     relevant links to use proper DocC symbol references.
+
 If a test has already started running and you determine it cannot complete and
-should end early without failing, use ``Test/cancel(_:sourceLocation:)`` instead
+should end early without failing, use `Test/cancel(_:sourceLocation:)` instead
 of [`XCTSkip`](https://developer.apple.com/documentation/xctest/xctskip) to
 cancel the task associated with the current test:
 
@@ -592,7 +594,7 @@ cancel the task associated with the current test:
 }
 
 If the test is parameterized and you only want to cancel the current test case
-rather than the entire test, use ``Test/Case/cancel(_:sourceLocation:)``.
+rather than the entire test, use `Test/Case/cancel(_:sourceLocation:)`.
 -->
 
 ### Annotate known issues

From 8b9128788a0a82ef6598a06af2feeb59698f7d69 Mon Sep 17 00:00:00 2001
From: Stuart Montgomery <smontgomery@apple.com>
Date: Tue, 16 Sep 2025 16:33:08 -0500
Subject: [PATCH 3/4] Fix link style

---
 Sources/Testing/Testing.docc/Documentation.md | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/Sources/Testing/Testing.docc/Documentation.md b/Sources/Testing/Testing.docc/Documentation.md
index d77583c0d..fb4ecc347 100644
--- a/Sources/Testing/Testing.docc/Documentation.md
+++ b/Sources/Testing/Testing.docc/Documentation.md
@@ -35,10 +35,8 @@ their problems.
 
 #### Related videos
 
-@Links(visualStyle: compactGrid) {
-  - https://developer.apple.com/videos/play/wwdc2024/10179
-  - https://developer.apple.com/videos/play/wwdc2024/10195
-}
+- [Meet Swift Testing](https://developer.apple.com/videos/play/wwdc2024/10179)
+- [Go further with Swift Testing](https://developer.apple.com/videos/play/wwdc2024/10195)
 
 ## Topics
 

From 42f9605e8736bd283a5a658d427e4a0b2e598aaf Mon Sep 17 00:00:00 2001
From: Stuart Montgomery <smontgomery@apple.com>
Date: Tue, 16 Sep 2025 16:49:08 -0500
Subject: [PATCH 4/4] Switch to official 6.2 container, now

---
 .github/workflows/pull_request.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/pull_request.yml b/.github/workflows/pull_request.yml
index 6639ec3ec..8c8480260 100644
--- a/.github/workflows/pull_request.yml
+++ b/.github/workflows/pull_request.yml
@@ -23,6 +23,6 @@ jobs:
     uses: swiftlang/github-workflows/.github/workflows/soundness.yml@main
     with:
       license_header_check_project_name: "Swift"
-      docs_check_container_image: "swiftlang/swift:nightly-6.2-noble"
+      docs_check_container_image: "swift:6.2-noble"
       format_check_enabled: false
       api_breakage_check_enabled: false