From a1cc86de6f562260555cdadc8c05941081c37067 Mon Sep 17 00:00:00 2001
From: Charlie Truong <chtruong@nvidia.com>
Date: Fri, 5 Jun 2026 06:24:07 -0500
Subject: [PATCH 1/3] ci: Remove build-docs test in favor of release test

Signed-off-by: Charlie Truong <chtruong@nvidia.com>
---
 .github/workflows/build-docs.yml | 65 --------------------------------
 1 file changed, 65 deletions(-)
 delete mode 100644 .github/workflows/build-docs.yml

diff --git a/.github/workflows/build-docs.yml b/.github/workflows/build-docs.yml
deleted file mode 100644
index f77e665d22f..00000000000
--- a/.github/workflows/build-docs.yml
+++ /dev/null
@@ -1,65 +0,0 @@
-# Copyright (c) 2025, NVIDIA CORPORATION.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-name: Build docs
-
-on:
-  push:
-    branches:
-      - main
-      - "pull-request/[0-9]+"
-      - "deploy-release/*"
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}-${{ github.event.label.name || 'main' }}-${{ github.event_name }}
-  cancel-in-progress: true
-
-jobs:
-  pre-flight:
-    uses: NVIDIA-NeMo/FW-CI-templates/.github/workflows/_cicd_preflight.yml@v1.0.0
-
-  build-docs:
-    needs: [pre-flight]
-    if: needs.pre-flight.outputs.is_deployment_workflow != 'true'
-    uses: NVIDIA-NeMo/FW-CI-templates/.github/workflows/_build_docs.yml@v1.0.0
-
-  build-docs-summary:
-    needs: [pre-flight, build-docs]
-    if: |
-      (
-        needs.pre-flight.outputs.is_deployment_workflow == 'true'
-        || always()
-      )
-      && !cancelled()
-    runs-on: ubuntu-latest
-    steps:
-      - name: Get workflow result
-        id: result
-        shell: bash -x -e -u -o pipefail {0}
-        env:
-          GH_TOKEN: ${{ github.token }}
-          RUN_ID: ${{ github.run_id }}
-          SKIPPING_IS_ALLOWED: ${{ needs.pre-flight.outputs.docs_only == 'true' || needs.pre-flight.outputs.is_deployment_workflow == 'true' }}
-        run: |
-          FAILED_JOBS=$(gh run view $GITHUB_RUN_ID --json jobs --jq '[.jobs[] | select(.status == "completed" and .conclusion != "success")] | length') || echo 0
-
-          if [ "${FAILED_JOBS:-0}" -eq 0 ] || [ "$SKIPPING_IS_ALLOWED" == "true" ]; then
-              echo "✅ All previous jobs completed successfully"
-              exit 0
-          else
-              echo "❌ Found $FAILED_JOBS failed job(s)"
-              # Show which jobs failed
-              gh run view $GITHUB_RUN_ID --json jobs --jq '.jobs[] | select(.status == "completed" and .conclusion != "success") | .name'
-              exit 1
-          fi

From 721d08ec7603627e513512a97ac31946e35472ef Mon Sep 17 00:00:00 2001
From: Charlie Truong <chtruong@nvidia.com>
Date: Fri, 5 Jun 2026 06:25:37 -0500
Subject: [PATCH 2/3] ci: Retry linkcheck failures in docs build

Signed-off-by: Charlie Truong <chtruong@nvidia.com>
---
 docs/conf.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/conf.py b/docs/conf.py
index c18f453490d..d60ea8c15ce 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -119,6 +119,8 @@
     ".*githubusercontent\\.com.*",
     "http://localhost.*",
 ]
+linkcheck_retries = 10
+linkcheck_rate_limit_timeout = 600
 
 # PyTorch docs use a JS-rendered frontend; anchor IDs are injected at runtime
 # and are not present in the static HTML that linkcheck fetches.

From e7bacbdd56a74ca283dc4c1bec909b1044ed4a40 Mon Sep 17 00:00:00 2001
From: Charlie Truong <chtruong@nvidia.com>
Date: Fri, 5 Jun 2026 06:45:26 -0500
Subject: [PATCH 3/3] Reduce link check workers to 1

Signed-off-by: Charlie Truong <chtruong@nvidia.com>
---
 docs/conf.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/conf.py b/docs/conf.py
index d60ea8c15ce..c3055bec4ab 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -121,6 +121,7 @@
 ]
 linkcheck_retries = 10
 linkcheck_rate_limit_timeout = 600
+linkcheck_workers = 1
 
 # PyTorch docs use a JS-rendered frontend; anchor IDs are injected at runtime
 # and are not present in the static HTML that linkcheck fetches.