Skip to content

ci: check go.php redirect targets against the master build - #15962

Merged
skjnldsv merged 3 commits into
masterfrom
ci/check-go-php-redirects
Oct 29, 2026
Merged

skjnldsv merged 3 commits into
masterfrom
ci/check-go-php-redirects

Conversation

@skjnldsv

Copy link
Copy Markdown
Member

☑️ Resolves

#15960 fixed a go.php target without a leading slash that 404'd. This adds a check to the master link-check job so it can't happen again: every target must start with /, the page must exist in the build, and its anchor must be an id on that page.

Running it against the current server/latest found two more broken redirects, fixed in the first commit:

  • admin-theming-icons pointed to #theming-of-icons, the heading anchor is #icon-theming. Server links to it from the theming admin settings.
  • admin-sso pointed to configuration_server/sso_configuration.html, which doesn't exist. I pointed it to the OpenID Connect page, the only SSO page we have. Happy to drop the key instead.

The script has a small test in build/tests/, run in the same step.

✅ Checklist

  • I have built the documentation locally and reviewed the output
  • Screenshots are included for visual changes
  • I have not moved or renamed pages (or added a redirect if I did)
  • I have run codespell or similar and addressed any spelling issues

👾 This pull request was assisted by Claude Code, commits carry an Assisted-by trailer.

admin-sso pointed to configuration_server/sso_configuration.html, which
is not part of the docs. Point it to the OpenID Connect page, the only
SSO page we have.

The theming icons heading anchor is #icon-theming, not
#theming-of-icons.

Assisted-by: ClaudeCode:claude-opus-5-5
Signed-off-by: John Molakvoæ <14975046+skjnldsv@users.noreply.github.com>
Every target must start with / (go.php appends it to the version path),
the page must exist in the build and its anchor must be an id on the
page. Runs in the link-check job, on master builds only, since go.php is
only deployed from master.

Assisted-by: ClaudeCode:claude-opus-5-5
Signed-off-by: John Molakvoæ <14975046+skjnldsv@users.noreply.github.com>
@skjnldsv skjnldsv self-assigned this Oct 28, 2026
@github-actions github-actions Bot added the github_actions Pull requests that update GitHub Actions code label Oct 28, 2026
@skjnldsv
skjnldsv requested a review from marcelklehr October 28, 2026 19:05
@skjnldsv
skjnldsv enabled auto-merge October 28, 2026 19:06
@github-actions

github-actions Bot commented Oct 28, 2026 •

Copy link
Copy Markdown
Contributor

📖 Documentation Preview

🔍 Open preview →

No RST documentation pages changed in this PR.

Last updated: Thu, 29 Oct 2026 01:45:08 GMT

go.php replaces the second user_manual segment with the reader's
language, and the staged build has no user_manual/index.html (the
deploy adds it). Check those targets the same way, against en.

Assisted-by: ClaudeCode:claude-opus-5-5
Signed-off-by: John Molakvoæ <14975046+skjnldsv@users.noreply.github.com>
@skjnldsv
skjnldsv merged commit 744ce6c into master Oct 29, 2026
28 checks passed
@skjnldsv
skjnldsv deleted the ci/check-go-php-redirects branch October 29, 2026 07:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

3. to review bug github_actions Pull requests that update GitHub Actions code

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants