Add comments to deprecated tests explaining that they aren't skipped

Author: d-ronnqvist

Tests/SwiftDocCTests/Converter/DocumentationConverterTests.swift

@@ -12,6 +12,8 @@
 import XCTest
 @testable import SwiftDocC
 
+// This test verifies the behavior of `DocumentationConverter` which is a deprecated type.
+// Deprecating the test silences the deprecation warning when running the tests. It doesn't skip the test.
 @available(*, deprecated, message: "This deprecated API will be removed after 6.2 is released")
 class DocumentationConverterTests: XCTestCase {
     /// An empty implementation of `ConvertOutputConsumer` that purposefully does nothing.

Tests/SwiftDocCTests/Infrastructure/BundleDiscoveryTests.swift

@@ -27,6 +27,7 @@ class BundleDiscoveryTests: XCTestCase {
     }
 
     // This tests registration of multiple catalogs which is deprecated
+    // Deprecating the test silences the deprecation warning when running the tests. It doesn't skip the test.
     @available(*, deprecated, message: "This deprecated API will be removed after 6.2 is released")
     func testFirstBundle() throws {
         let url = try createTemporaryDirectory()
@@ -63,6 +64,7 @@ class BundleDiscoveryTests: XCTestCase {
     }
 
     // This test registration more than once data provider which is deprecated.
+    // Deprecating the test silences the deprecation warning when running the tests. It doesn't skip the test.
     @available(*, deprecated, message: "This deprecated API will be removed after 6.2 is released")
     func testLoadComplexWorkspace() throws {
         let allFiles = try flatListOfFiles()

Tests/SwiftDocCTests/Infrastructure/DocumentationContext/DocumentationContextTests.swift

@@ -37,6 +37,7 @@ extension CollectionDifference {
 
 class DocumentationContextTests: XCTestCase {
     // This test checks unregistration of workspace data providers which is deprecated
+    // Deprecating the test silences the deprecation warning when running the tests. It doesn't skip the test.
     @available(*, deprecated, message: "This deprecated API will be removed after 6.2 is released")
     func testResolve() throws {
         let workspace = DocumentationWorkspace()
@@ -602,6 +603,7 @@ class DocumentationContextTests: XCTestCase {
     }
 
     // This test registration more than once data provider which is deprecated.
+    // Deprecating the test silences the deprecation warning when running the tests. It doesn't skip the test.
     @available(*, deprecated, message: "This deprecated API will be removed after 6.2 is released")
     func testCreatesCorrectIdentifiers() throws {
         let testBundleLocation = Bundle.module.url(

Tests/SwiftDocCTests/Infrastructure/DocumentationWorkspaceTests.swift

@@ -11,6 +11,8 @@
 import XCTest
 @testable import SwiftDocC
 
+// This test verifies the behavior of `DocumentationWorkspace` which is a deprecated type.
+// Deprecating the test silences the deprecation warning when running the tests. It doesn't skip the test.
 @available(*, deprecated, message: "This deprecated API will be removed after 6.2 is released")
 class DocumentationWorkspaceTests: XCTestCase {
     func testEmptyWorkspace() {

Tests/SwiftDocCTests/Infrastructure/GeneratedDataProvider.swift

@@ -12,6 +12,8 @@ import XCTest
 @testable import SwiftDocC
 import SymbolKit
 
+// This test verifies the behavior of `GeneratedDataProvider` which is a deprecated type.
+// Deprecating the test silences the deprecation warning when running the tests. It doesn't skip the test.
 @available(*, deprecated, message: "Use 'DocumentationContext.InputProvider' instead. This deprecated API will be removed after 6.2 is released")
 class GeneratedDataProviderTests: XCTestCase {
 

Tests/SwiftDocCTests/Infrastructure/Input Discovery/DocumentationInputsProviderTests.swift

@@ -15,6 +15,7 @@ import SwiftDocCTestUtilities
 class DocumentationInputsProviderTests: XCTestCase {
 
     // After 6.2 we can update this test to verify that the input provider discovers the same inputs regardless of FileManagerProtocol
+    // Deprecating the test silences the deprecation warning when running the tests. It doesn't skip the test.
     @available(*, deprecated, message: "This test uses `LocalFileSystemDataProvider` as a `DocumentationWorkspaceDataProvider` which is deprecated and will be removed after 6.2 is released")
     func testDiscoversSameFilesAsPreviousImplementation() throws {
         let folderHierarchy = Folder(name: "one", content: [