From 35dde6dadb735f37ffc9894e82dd01d41b659b59 Mon Sep 17 00:00:00 2001 From: Kristin Brown Date: Wed, 19 Aug 2026 11:55:24 -0400 Subject: [PATCH 1/6] Theme upgrade Signed-off-by: Kristin Brown --- Makefile | 15 +++++++++++---- go.mod | 2 +- go.sum | 16 ++++++++++++++++ 3 files changed, 28 insertions(+), 5 deletions(-) diff --git a/Makefile b/Makefile index 1a64d63..4f18284 100644 --- a/Makefile +++ b/Makefile @@ -41,6 +41,13 @@ FRAMEWORK_EXTRAS_DIR ?= ../docs-theme-extras # One-time install: npm packages + Playwright browser binaries in the harness # checkout. ~120-180 MB, ~1-3 minutes. +# Serving the HTML report binds a port and BLOCKS until interrupted, so it must +# never run unattended: in CI it hangs the job, and in any scripted/non-tty run +# it hangs the caller. Gate it on an interactive terminal AND the absence of CI. +# The report is still written to playwright-report/ either way — view it with +# `make framework-test-report`. +SHOW_REPORT = if [ -t 1 ] && [ -z "$$CI" ]; then npx playwright show-report; fi + .PHONY: framework-test-install framework-test-install: @if [ ! -d "$(FRAMEWORK_EXTRAS_DIR)" ]; then \ @@ -60,7 +67,7 @@ framework-test: hugo160 --gc --minify > .build.log 2>&1 cd $(FRAMEWORK_EXTRAS_DIR) && \ (DOCS_TEST_CONFIG=$(abspath ./.docs-test.toml) npx playwright test; \ - result=$$?; npx playwright show-report; exit $$result) + result=$$?; $(SHOW_REPORT); exit $$result) # Fastest loop — static specs only, no browser launch. .PHONY: framework-test-static @@ -70,7 +77,7 @@ framework-test-static: hugo160 --gc --minify > .build.log 2>&1 cd $(FRAMEWORK_EXTRAS_DIR) && \ (DOCS_TEST_CONFIG=$(abspath ./.docs-test.toml) npx playwright test --project=static; \ - result=$$?; npx playwright show-report; exit $$result) + result=$$?; $(SHOW_REPORT); exit $$result) # Chromium browser specs (tabs, mermaid, theme toggle, copy-md, console errors, # viewport, contrast). @@ -81,7 +88,7 @@ framework-test-browser: hugo160 --gc --minify > .build.log 2>&1 cd $(FRAMEWORK_EXTRAS_DIR) && \ (DOCS_TEST_CONFIG=$(abspath ./.docs-test.toml) npx playwright test --project=browser; \ - result=$$?; npx playwright show-report; exit $$result) + result=$$?; $(SHOW_REPORT); exit $$result) # Cross-browser desktop specs across chromium, firefox, and webkit. .PHONY: framework-test-cross-browser @@ -94,7 +101,7 @@ framework-test-cross-browser: --project=cross-browser-chromium \ --project=cross-browser-firefox \ --project=cross-browser-webkit; \ - result=$$?; npx playwright show-report; exit $$result) + result=$$?; $(SHOW_REPORT); exit $$result) # Open the most recent Playwright HTML report. .PHONY: framework-test-report diff --git a/go.mod b/go.mod index 7a0ea4d..ee7e5f5 100644 --- a/go.mod +++ b/go.mod @@ -5,4 +5,4 @@ go 1.25.1 // docs-theme-extras declares the hextra import itself (pinned to v0.12.3), so // hextra is a transitive dependency and is not listed here — matching // agentgateway / kgateway / ambientmesh. Its checksums stay in go.sum. -require github.com/solo-io/docs-theme-extras v0.1.25 // indirect +require github.com/solo-io/docs-theme-extras v0.2.0-beta.13 // indirect diff --git a/go.sum b/go.sum index ed1bbca..32a1ae7 100644 --- a/go.sum +++ b/go.sum @@ -1,2 +1,18 @@ github.com/solo-io/docs-theme-extras v0.1.25 h1:9SvHWXlrBxgk3/0NnV+JvkqQ7/rww4daIzdCYtSubVg= github.com/solo-io/docs-theme-extras v0.1.25/go.mod h1:jjjYu/QoD+vMu30zgcpfEuTEGuJOJWs5qai/K18kltg= +github.com/solo-io/docs-theme-extras v0.1.26-beta.1 h1:NB0NHr6xX1OrDe3yoH6nkzoHiH58bIi73R1smmdtZBs= +github.com/solo-io/docs-theme-extras v0.1.26-beta.1/go.mod h1:jjjYu/QoD+vMu30zgcpfEuTEGuJOJWs5qai/K18kltg= +github.com/solo-io/docs-theme-extras v0.2.0-beta.1 h1:+kRKHMM0hWMnaPMQF4/nPGPzsVFPCtUlwdBRfNf+NLo= +github.com/solo-io/docs-theme-extras v0.2.0-beta.1/go.mod h1:jjjYu/QoD+vMu30zgcpfEuTEGuJOJWs5qai/K18kltg= +github.com/solo-io/docs-theme-extras v0.2.0-beta.2 h1:ynyoToo5C8Ts3WrQXR1G4Uu28S4YuGydbBMvmesk4yk= +github.com/solo-io/docs-theme-extras v0.2.0-beta.2/go.mod h1:jjjYu/QoD+vMu30zgcpfEuTEGuJOJWs5qai/K18kltg= +github.com/solo-io/docs-theme-extras v0.2.0-beta.3 h1:NGuto3wGVsB9Ev6gOGDLYWAaSA9lC1Q3c4EU6lsVZVA= +github.com/solo-io/docs-theme-extras v0.2.0-beta.3/go.mod h1:jjjYu/QoD+vMu30zgcpfEuTEGuJOJWs5qai/K18kltg= +github.com/solo-io/docs-theme-extras v0.2.0-beta.4 h1:qPHacB9yyv4KUkubu37LyYHI8vcMvB2W24vmD79gGAw= +github.com/solo-io/docs-theme-extras v0.2.0-beta.4/go.mod h1:jjjYu/QoD+vMu30zgcpfEuTEGuJOJWs5qai/K18kltg= +github.com/solo-io/docs-theme-extras v0.2.0-beta.5 h1:WQbRe9dzriVgpXXnLjh59XWWz+2zx01CZP9Q1GSLp00= +github.com/solo-io/docs-theme-extras v0.2.0-beta.5/go.mod h1:jjjYu/QoD+vMu30zgcpfEuTEGuJOJWs5qai/K18kltg= +github.com/solo-io/docs-theme-extras v0.2.0-beta.6 h1:6nct2RC86ius2ruWW7j1jPNm3YjXDFpdxab2ypZciUM= +github.com/solo-io/docs-theme-extras v0.2.0-beta.6/go.mod h1:jjjYu/QoD+vMu30zgcpfEuTEGuJOJWs5qai/K18kltg= +github.com/solo-io/docs-theme-extras v0.2.0-beta.13 h1:dHS5XZKRQEKobUv2UFxSDUQSXHvwclyjATxI3XkXyjI= +github.com/solo-io/docs-theme-extras v0.2.0-beta.13/go.mod h1:jjjYu/QoD+vMu30zgcpfEuTEGuJOJWs5qai/K18kltg= From 4c605496ec8790db3aab75b49de94e53810e474e Mon Sep 17 00:00:00 2001 From: Kristin Brown Date: Wed, 19 Aug 2026 12:16:34 -0400 Subject: [PATCH 2/6] Updated go mod and added timeout Signed-off-by: Kristin Brown --- .github/workflows/framework-tests.yml | 4 ++++ go.mod | 2 +- go.sum | 2 ++ 3 files changed, 7 insertions(+), 1 deletion(-) diff --git a/.github/workflows/framework-tests.yml b/.github/workflows/framework-tests.yml index 3822814..84c393a 100644 --- a/.github/workflows/framework-tests.yml +++ b/.github/workflows/framework-tests.yml @@ -48,6 +48,10 @@ jobs: name: Static + content checks runs-on: ubuntu-latest continue-on-error: true + # Bounds a hung `Install chromium` / apt-get step (observed stuck 30+ min + # with no failure — GitHub's default job timeout is 6 hours) so the run + # fails fast instead of sitting until that default kicks in. + timeout-minutes: 15 steps: - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2 - uses: actions/setup-go@4b73464bb391d4059bd26b0524d20df3927bd417 # v6.3.0 diff --git a/go.mod b/go.mod index ee7e5f5..292d340 100644 --- a/go.mod +++ b/go.mod @@ -5,4 +5,4 @@ go 1.25.1 // docs-theme-extras declares the hextra import itself (pinned to v0.12.3), so // hextra is a transitive dependency and is not listed here — matching // agentgateway / kgateway / ambientmesh. Its checksums stay in go.sum. -require github.com/solo-io/docs-theme-extras v0.2.0-beta.13 // indirect +require github.com/solo-io/docs-theme-extras v0.2.0-beta.14 // indirect diff --git a/go.sum b/go.sum index 32a1ae7..670032a 100644 --- a/go.sum +++ b/go.sum @@ -16,3 +16,5 @@ github.com/solo-io/docs-theme-extras v0.2.0-beta.6 h1:6nct2RC86ius2ruWW7j1jPNm3Y github.com/solo-io/docs-theme-extras v0.2.0-beta.6/go.mod h1:jjjYu/QoD+vMu30zgcpfEuTEGuJOJWs5qai/K18kltg= github.com/solo-io/docs-theme-extras v0.2.0-beta.13 h1:dHS5XZKRQEKobUv2UFxSDUQSXHvwclyjATxI3XkXyjI= github.com/solo-io/docs-theme-extras v0.2.0-beta.13/go.mod h1:jjjYu/QoD+vMu30zgcpfEuTEGuJOJWs5qai/K18kltg= +github.com/solo-io/docs-theme-extras v0.2.0-beta.14 h1:dVd+Iwfg/5mF4Yxxqsjt9TZSVd7WRSuZisOdNNo+Zgs= +github.com/solo-io/docs-theme-extras v0.2.0-beta.14/go.mod h1:jjjYu/QoD+vMu30zgcpfEuTEGuJOJWs5qai/K18kltg= From 4a23d7289a1f41042532ef3854dd959a004d5424 Mon Sep 17 00:00:00 2001 From: Kristin Brown Date: Wed, 19 Aug 2026 12:25:16 -0400 Subject: [PATCH 3/6] Added chromium Signed-off-by: Kristin Brown --- .github/workflows/framework-tests.yml | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/.github/workflows/framework-tests.yml b/.github/workflows/framework-tests.yml index 84c393a..ffc0b21 100644 --- a/.github/workflows/framework-tests.yml +++ b/.github/workflows/framework-tests.yml @@ -120,6 +120,10 @@ jobs: working-directory: docs-theme-extras run: npm ci + - name: Install chromium + working-directory: docs-theme-extras + run: npx playwright install --with-deps chromium + - name: Run static + content specs working-directory: docs-theme-extras env: From 9db04e87ac169515e0148c18b099a40f4d56dcc8 Mon Sep 17 00:00:00 2001 From: Kristin Brown Date: Wed, 19 Aug 2026 12:59:27 -0400 Subject: [PATCH 4/6] apt mirror fix Signed-off-by: Kristin Brown --- .github/workflows/framework-tests.yml | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/.github/workflows/framework-tests.yml b/.github/workflows/framework-tests.yml index ffc0b21..b095a71 100644 --- a/.github/workflows/framework-tests.yml +++ b/.github/workflows/framework-tests.yml @@ -120,6 +120,19 @@ jobs: working-directory: docs-theme-extras run: npm ci + # ubuntu-latest resolves apt's default mirror to a region-specific + # azure.archive.ubuntu.com endpoint that has repeatedly gone unreachable + # outright (apt-get update stalls on endless "Ign:" retries instead of + # failing) — same root cause as the timeout guard above. Point apt at + # the direct global mirror before Playwright's installer shells out to + # apt-get, instead of just waiting longer. + - name: Work around flaky azure.archive.ubuntu.com apt mirror + run: | + sudo sed -i 's|azure\.archive\.ubuntu\.com|archive.ubuntu.com|g' \ + /etc/apt/sources.list \ + /etc/apt/sources.list.d/*.sources \ + /etc/apt/apt-mirrors.txt 2>/dev/null || true + - name: Install chromium working-directory: docs-theme-extras run: npx playwright install --with-deps chromium From 616ef3bd7272efb9dd5b5153829c8fe7f0a6f928 Mon Sep 17 00:00:00 2001 From: Kristin Brown Date: Thu, 20 Aug 2026 09:55:19 -0400 Subject: [PATCH 5/6] Go mod updates Signed-off-by: Kristin Brown --- go.mod | 2 +- go.sum | 22 ++-------------------- 2 files changed, 3 insertions(+), 21 deletions(-) diff --git a/go.mod b/go.mod index 292d340..09d4f70 100644 --- a/go.mod +++ b/go.mod @@ -5,4 +5,4 @@ go 1.25.1 // docs-theme-extras declares the hextra import itself (pinned to v0.12.3), so // hextra is a transitive dependency and is not listed here — matching // agentgateway / kgateway / ambientmesh. Its checksums stay in go.sum. -require github.com/solo-io/docs-theme-extras v0.2.0-beta.14 // indirect +require github.com/solo-io/docs-theme-extras v0.2.0-beta.15 // indirect diff --git a/go.sum b/go.sum index 670032a..1d260ce 100644 --- a/go.sum +++ b/go.sum @@ -1,20 +1,2 @@ -github.com/solo-io/docs-theme-extras v0.1.25 h1:9SvHWXlrBxgk3/0NnV+JvkqQ7/rww4daIzdCYtSubVg= -github.com/solo-io/docs-theme-extras v0.1.25/go.mod h1:jjjYu/QoD+vMu30zgcpfEuTEGuJOJWs5qai/K18kltg= -github.com/solo-io/docs-theme-extras v0.1.26-beta.1 h1:NB0NHr6xX1OrDe3yoH6nkzoHiH58bIi73R1smmdtZBs= -github.com/solo-io/docs-theme-extras v0.1.26-beta.1/go.mod h1:jjjYu/QoD+vMu30zgcpfEuTEGuJOJWs5qai/K18kltg= -github.com/solo-io/docs-theme-extras v0.2.0-beta.1 h1:+kRKHMM0hWMnaPMQF4/nPGPzsVFPCtUlwdBRfNf+NLo= -github.com/solo-io/docs-theme-extras v0.2.0-beta.1/go.mod h1:jjjYu/QoD+vMu30zgcpfEuTEGuJOJWs5qai/K18kltg= -github.com/solo-io/docs-theme-extras v0.2.0-beta.2 h1:ynyoToo5C8Ts3WrQXR1G4Uu28S4YuGydbBMvmesk4yk= -github.com/solo-io/docs-theme-extras v0.2.0-beta.2/go.mod h1:jjjYu/QoD+vMu30zgcpfEuTEGuJOJWs5qai/K18kltg= -github.com/solo-io/docs-theme-extras v0.2.0-beta.3 h1:NGuto3wGVsB9Ev6gOGDLYWAaSA9lC1Q3c4EU6lsVZVA= -github.com/solo-io/docs-theme-extras v0.2.0-beta.3/go.mod h1:jjjYu/QoD+vMu30zgcpfEuTEGuJOJWs5qai/K18kltg= -github.com/solo-io/docs-theme-extras v0.2.0-beta.4 h1:qPHacB9yyv4KUkubu37LyYHI8vcMvB2W24vmD79gGAw= -github.com/solo-io/docs-theme-extras v0.2.0-beta.4/go.mod h1:jjjYu/QoD+vMu30zgcpfEuTEGuJOJWs5qai/K18kltg= -github.com/solo-io/docs-theme-extras v0.2.0-beta.5 h1:WQbRe9dzriVgpXXnLjh59XWWz+2zx01CZP9Q1GSLp00= -github.com/solo-io/docs-theme-extras v0.2.0-beta.5/go.mod h1:jjjYu/QoD+vMu30zgcpfEuTEGuJOJWs5qai/K18kltg= -github.com/solo-io/docs-theme-extras v0.2.0-beta.6 h1:6nct2RC86ius2ruWW7j1jPNm3YjXDFpdxab2ypZciUM= -github.com/solo-io/docs-theme-extras v0.2.0-beta.6/go.mod h1:jjjYu/QoD+vMu30zgcpfEuTEGuJOJWs5qai/K18kltg= -github.com/solo-io/docs-theme-extras v0.2.0-beta.13 h1:dHS5XZKRQEKobUv2UFxSDUQSXHvwclyjATxI3XkXyjI= -github.com/solo-io/docs-theme-extras v0.2.0-beta.13/go.mod h1:jjjYu/QoD+vMu30zgcpfEuTEGuJOJWs5qai/K18kltg= -github.com/solo-io/docs-theme-extras v0.2.0-beta.14 h1:dVd+Iwfg/5mF4Yxxqsjt9TZSVd7WRSuZisOdNNo+Zgs= -github.com/solo-io/docs-theme-extras v0.2.0-beta.14/go.mod h1:jjjYu/QoD+vMu30zgcpfEuTEGuJOJWs5qai/K18kltg= +github.com/solo-io/docs-theme-extras v0.2.0-beta.15 h1:I/7A2Rf5c3bCcB9KcsrvjeccGFQiEcaNaU5rjEe2hHQ= +github.com/solo-io/docs-theme-extras v0.2.0-beta.15/go.mod h1:jjjYu/QoD+vMu30zgcpfEuTEGuJOJWs5qai/K18kltg= From b22bb8699dbb793e9a158cbdfd3bbee70dc94305 Mon Sep 17 00:00:00 2001 From: Kristin Brown Date: Thu, 20 Aug 2026 11:10:14 -0400 Subject: [PATCH 6/6] Updated go mod Signed-off-by: Kristin Brown --- go.mod | 2 +- go.sum | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/go.mod b/go.mod index 09d4f70..a8bf896 100644 --- a/go.mod +++ b/go.mod @@ -5,4 +5,4 @@ go 1.25.1 // docs-theme-extras declares the hextra import itself (pinned to v0.12.3), so // hextra is a transitive dependency and is not listed here — matching // agentgateway / kgateway / ambientmesh. Its checksums stay in go.sum. -require github.com/solo-io/docs-theme-extras v0.2.0-beta.15 // indirect +require github.com/solo-io/docs-theme-extras v0.2.0 // indirect diff --git a/go.sum b/go.sum index 1d260ce..860f50b 100644 --- a/go.sum +++ b/go.sum @@ -1,2 +1,2 @@ -github.com/solo-io/docs-theme-extras v0.2.0-beta.15 h1:I/7A2Rf5c3bCcB9KcsrvjeccGFQiEcaNaU5rjEe2hHQ= -github.com/solo-io/docs-theme-extras v0.2.0-beta.15/go.mod h1:jjjYu/QoD+vMu30zgcpfEuTEGuJOJWs5qai/K18kltg= +github.com/solo-io/docs-theme-extras v0.2.0 h1:GShYCtM7oUC3UqHOqCPwPzsKe9jKdA1OXC0LVqo+h7w= +github.com/solo-io/docs-theme-extras v0.2.0/go.mod h1:jjjYu/QoD+vMu30zgcpfEuTEGuJOJWs5qai/K18kltg=