docc validation needs JAVA_HOME to be set up

Author: ktoso

.github/workflows/pull_request.yml

@@ -13,6 +13,32 @@ jobs:
       # FIXME: Something is off with the format task and it gets "stuck", need to investigate
       format_check_enabled: false
       license_header_check_project_name: Swift.org
+      # Since we need JAVA_HOME to be set up for building the project and depending on a different workflow won't
+      # give us that, we disable the checking and make a separate job that performs docs validation
+      docs_check_enabled: false
+
+  # This replicates 'docs-check' from https://github.com/swiftlang/github-workflows/blob/main/.github/workflows/soundness.yml
+  # because we need to set up environment so we can build the SwiftJava project (including Java runtime/dependencies).
+  soundness-docs:
+    name: Documentation check
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: true
+      matrix:
+        swift_version: ['6.1.2']
+        os_version: ['jammy']
+        jdk_vendor: ['corretto']
+    container:
+      image: ${{ (contains(matrix.swift_version, 'nightly') && 'swiftlang/swift') || 'swift' }}:${{ matrix.swift_version }}-${{ matrix.os_version }}
+    steps:
+      - uses: actions/checkout@v4
+      - name: Prepare CI Environment
+        uses: ./.github/actions/prepare_env
+      - name: Run documentation check
+        run: |
+          which curl yq || (apt -q update && apt -yq install curl yq)
+          curl -s --retry 3 https://raw.githubusercontent.com/swiftlang/github-workflows/refs/heads/main/.github/workflows/scripts/check-docs.sh | bash
+
 
   test-java:
     name: Test (Java) (${{ matrix.os_version }} swift:${{ matrix.swift_version }} jdk:${{matrix.jdk_vendor}})