Merge remote-tracking branch 'remotes/3405691582/embed' into embed

Author: grynspan

.github/workflows/pull_request.yml

@@ -14,7 +14,6 @@ jobs:
     uses: swiftlang/github-workflows/.github/workflows/swift_package_test.yml@main
     with:
       linux_swift_versions: '["nightly-main", "nightly-6.2"]'
-      linux_os_versions: '["amazonlinux2", "jammy"]'
       windows_swift_versions: '["nightly-main", "nightly-6.2"]'
       enable_macos_checks: true
       macos_exclude_xcode_versions: "[{\"xcode_version\": \"16.2\"}, {\"xcode_version\": \"16.3\"}]"
@@ -24,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: "swift:6.2-noble"
       format_check_enabled: false
       api_breakage_check_enabled: false

Sources/Testing/Testing.docc/Documentation.md

@@ -35,10 +35,8 @@ their problems.
 
 #### Related videos
 
-@Links(visualStyle: compactGrid) {
-  - <doc://com.apple.documentation/videos/play/wwdc2024/10179>
-  - <doc://com.apple.documentation/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
 

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