From 4c7f23d69134544d2ac7fa8492d97fc7df628c87 Mon Sep 17 00:00:00 2001
From: Julian Nguyen <109386615+juliannguyen4@users.noreply.github.com>
Date: Wed, 11 Mar 2026 09:11:53 -0700
Subject: [PATCH 1/4] Increase linkcheck's retry count to 4

---
 doc/conf.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/doc/conf.py b/doc/conf.py
index 171c556781..0f030e1bcb 100755
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -269,4 +269,5 @@ def __getattr__(cls, name):
     "https://docs.aerospike.com/server/guide/security/index.html"
 ]
 
-linkcheck_timeout = 120
+linkcheck_timeout = 30
+linkcheck_retries = 4

From e22806367608b86e77601dabb35fd3ede9bd5dd4 Mon Sep 17 00:00:00 2001
From: Julian Nguyen <109386615+juliannguyen4@users.noreply.github.com>
Date: Wed, 11 Mar 2026 09:21:44 -0700
Subject: [PATCH 2/4] Run with double verbosity to make easier to debug

---
 .github/workflows/doc-tests.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/doc-tests.yml b/.github/workflows/doc-tests.yml
index ff778ec58f..1a633b6546 100644
--- a/.github/workflows/doc-tests.yml
+++ b/.github/workflows/doc-tests.yml
@@ -34,7 +34,7 @@ jobs:
         builder-command:
         - 'spelling . spelling -W --keep-going'
         # -vv is too verbose and makes it hard to read logs
-        - 'linkcheck -v . links'
+        - 'linkcheck -vv . links'
     steps:
     - name: Harden the runner (Audit all outbound calls)
       uses: step-security/harden-runner@a90bcbc6539c36a85cdfeb73f7e2f433735f215b # v2.15.0

From 569aef686bfbbd7a5b36103040822c9a7ad3ae73 Mon Sep 17 00:00:00 2001
From: Julian Nguyen <109386615+juliannguyen4@users.noreply.github.com>
Date: Wed, 11 Mar 2026 10:07:28 -0700
Subject: [PATCH 3/4] Since bug happens on Github Actions, get bug report from
 there.

---
 .github/workflows/doc-tests.yml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/.github/workflows/doc-tests.yml b/.github/workflows/doc-tests.yml
index 1a633b6546..c1a38cd40a 100644
--- a/.github/workflows/doc-tests.yml
+++ b/.github/workflows/doc-tests.yml
@@ -52,5 +52,9 @@ jobs:
       # TODO: find way to split up dependencies
       run: python -m pip install -r doc/requirements.txt
     - name: Run builder
+      id: builder
       run: sphinx-build -b ${{ matrix.builder-command }}
       working-directory: doc
+    - if: ${{ steps.builder.outcome == 'failure' }}
+      run: sphinx-build --bug-report
+      working-directory: doc

From 5de93f011293a58c48156b2153017f97e08cfbcb Mon Sep 17 00:00:00 2001
From: Julian Nguyen <109386615+juliannguyen4@users.noreply.github.com>
Date: Wed, 11 Mar 2026 10:11:36 -0700
Subject: [PATCH 4/4] Forgot to override success() condition

---
 .github/workflows/doc-tests.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/doc-tests.yml b/.github/workflows/doc-tests.yml
index c1a38cd40a..b06bead030 100644
--- a/.github/workflows/doc-tests.yml
+++ b/.github/workflows/doc-tests.yml
@@ -55,6 +55,6 @@ jobs:
       id: builder
       run: sphinx-build -b ${{ matrix.builder-command }}
       working-directory: doc
-    - if: ${{ steps.builder.outcome == 'failure' }}
+    - if: ${{ !cancelled() && steps.builder.outcome == 'failure' }}
       run: sphinx-build --bug-report
       working-directory: doc