Nope, doesn't work, just disable the docs check

Author: grynspan

.github/workflows/pull_request.yml

@@ -24,7 +24,6 @@ jobs:
     uses: swiftlang/github-workflows/.github/workflows/soundness.yml@main
     with:
       license_header_check_project_name: "Swift"
-      docs_check_container_image: "swift:6.2-noble"
-      docs_check_additional_arguments: "--emit-digest"
+      docs_check_enabled: false
       format_check_enabled: false
       api_breakage_check_enabled: false

Package.swift

@@ -36,12 +36,6 @@ let buildingForEmbedded: Bool = {
   return Bool(envvar) ?? ((Int(envvar) ?? 0) != 0)
 }()
 
-/// Whether or not we appear to be building the package for the documentation
-/// soundness check we run in GitHub Actions.
-let buildingForDocumentationSoundnessCheck: Bool = {
-  Context.environment["ADDITIONAL_DOCC_ARGUMENTS"] != nil
-}()
-
 let package = Package(
   name: "swift-testing",
 
@@ -395,12 +389,6 @@ extension Array where Element == PackageDescription.SwiftSetting {
       .define("SWT_NO_LIBDISPATCH", .whenEmbedded()),
     ]
 
-    if buildingForDocumentationSoundnessCheck {
-      result += [
-        .define("SWT_DOCC", .whenEmbedded()),
-      ]
-    }
-
     return result
   }
 

Sources/Testing/Attachments/Images/AttachableImageFormat.swift

@@ -31,7 +31,7 @@
 /// @Metadata {
 ///   @Available(Swift, introduced: 6.3)
 /// }
-#if SWT_NO_IMAGE_ATTACHMENTS && !SWT_DOCC
+#if SWT_NO_IMAGE_ATTACHMENTS
 @available(*, unavailable, message: "Image attachments are not available on this platform.")
 #endif
 @available(_uttypesAPI, *)
@@ -80,7 +80,7 @@ public struct AttachableImageFormat: Sendable {
 
 // MARK: -
 
-#if SWT_NO_IMAGE_ATTACHMENTS && !SWT_DOCC
+#if SWT_NO_IMAGE_ATTACHMENTS
 @available(*, unavailable, message: "Image attachments are not available on this platform.")
 #endif
 @available(_uttypesAPI, *)

Sources/Testing/Attachments/Images/Attachment+_AttachableAsImage.swift

@@ -8,7 +8,7 @@
 // See https://swift.org/CONTRIBUTORS.txt for Swift project authors
 //
 
-#if SWT_NO_IMAGE_ATTACHMENTS && !SWT_DOCC
+#if SWT_NO_IMAGE_ATTACHMENTS
 @available(*, unavailable, message: "Image attachments are not available on this platform.")
 #endif
 @available(_uttypesAPI, *)
@@ -104,7 +104,7 @@ extension Attachment {
 // MARK: -
 
 @_spi(Experimental) // STOP: not part of ST-0014
-#if SWT_NO_IMAGE_ATTACHMENTS && !SWT_DOCC
+#if SWT_NO_IMAGE_ATTACHMENTS
 @available(*, unavailable, message: "Image attachments are not available on this platform.")
 #endif
 @available(_uttypesAPI, *)

Sources/Testing/Attachments/Images/ImageAttachmentError.swift

@@ -11,7 +11,7 @@
 private import _TestingInternals
 
 /// A type representing an error that can occur when attaching an image.
-#if SWT_NO_IMAGE_ATTACHMENTS && !SWT_DOCC
+#if SWT_NO_IMAGE_ATTACHMENTS
 @available(*, unavailable, message: "Image attachments are not available on this platform.")
 #endif
 package enum ImageAttachmentError: Error {
@@ -42,7 +42,7 @@ package enum ImageAttachmentError: Error {
 #endif
 }
 
-#if SWT_NO_IMAGE_ATTACHMENTS && !SWT_DOCC
+#if SWT_NO_IMAGE_ATTACHMENTS
 @available(*, unavailable, message: "Image attachments are not available on this platform.")
 #endif
 extension ImageAttachmentError: CustomStringConvertible {

Sources/Testing/Attachments/Images/_AttachableAsImage.swift

@@ -12,8 +12,6 @@
 // Image attachments on Apple platforms conform to AttachableAsCGImage.
 #elseif os(Windows)
 // Image attachments on Windows platforms conform to AttachableAsIWICBitmapSource.
-#elseif SWT_DOCC
-// Image attachments aren't supported, but we're just building the docs.
 #elseif !SWT_NO_IMAGE_ATTACHMENTS
 #error("Platform-specific misconfiguration: support for image attachments requires a platform-specific implementation")
 #endif
@@ -28,7 +26,7 @@
 ///   A future Swift Evolution proposal will promote this protocol to API so
 ///   that we don't need to underscore its name.
 /// }
-#if SWT_NO_IMAGE_ATTACHMENTS && !SWT_DOCC
+#if SWT_NO_IMAGE_ATTACHMENTS
 @available(*, unavailable, message: "Image attachments are not available on this platform.")
 #endif
 @available(_uttypesAPI, *)

Sources/Testing/Attachments/Images/_AttachableImageWrapper.swift

@@ -20,7 +20,7 @@
 /// @Comment {
 /// | Windows | [`HBITMAP`](https://learn.microsoft.com/en-us/windows/win32/gdi/bitmaps), [`HICON`](https://learn.microsoft.com/en-us/windows/win32/menurc/icons), [`IWICBitmapSource`](https://learn.microsoft.com/en-us/windows/win32/api/wincodec/nn-wincodec-iwicbitmapsource) (including its subclasses declared by Windows Imaging Component) |
 /// }
-#if SWT_NO_IMAGE_ATTACHMENTS && !SWT_DOCC
+#if SWT_NO_IMAGE_ATTACHMENTS
 @available(*, unavailable, message: "Image attachments are not available on this platform.")
 #endif
 @available(_uttypesAPI, *)
@@ -41,7 +41,7 @@ public final class _AttachableImageWrapper<Image>: Sendable where Image: _Attach
   }
 }
 
-#if SWT_NO_IMAGE_ATTACHMENTS && !SWT_DOCC
+#if SWT_NO_IMAGE_ATTACHMENTS
 @available(*, unavailable, message: "Image attachments are not available on this platform.")
 #endif
 @available(_uttypesAPI, *)