Skip to content

Add redirects for the 404s left after #63 - #64

Merged
agoldis merged 1 commit into
mainfrom
fix/redirect-map-gaps
Aug 8, 2026
Merged

Add redirects for the 404s left after #63#64
agoldis merged 1 commit into
mainfrom
fix/redirect-map-gaps

Conversation

@agoldis

@agoldis agoldis commented Aug 8, 2026

Copy link
Copy Markdown
Contributor

User description

Stacked on #63 — based on fix/broken-links-and-redirects, so the diff shows only the 12 new entries. Merge #63 first, then this retargets to main automatically.

What

Twelve .gitbook.yaml redirect entries for URLs that still hard-404.

Why

Search Console reports 91 crawled 404s on docs.currents.dev. #63 already covers ten that are real page moves. These are the remainder — including every path still reachable from currents.dev/readme/*, which is being converted from a proxy rewrite to a 301 in currents-dev/www.currents.dev#250.

Bare CI-provider paths (4) — predate flattening the ci-setup tree:

ci-setup/circleci           -> getting-started/ci-setup/playwright-circleci.md
ci-setup/azure-devops       -> getting-started/ci-setup/playwright-azure-devops.md
ci-setup/bitbucket          -> .../cypress/ci-setup/cypress-bitbucket-pipelines.md
ci-setup/jenkins-playwright -> getting-started/ci-setup/jenkins.md

Files with those names still exist at the repo root but are absent from SUMMARY.md, so GitBook doesn't serve them — which is why they 404. These entries are additive and leave the files alone. Whether that unlisted ci-setup/ directory should exist at all is a separate question; ci-setup/jenkins-playwright.md is 76 lines of real content, so I didn't touch it.

Pages that moved section (8) — currents-cli to resources/reporters, jira to resources/integrations, currents-actions and the orchestrated re-run guide to their current homes, plus projects, webhooks, actions.

Verification

Every target URL returns 200 on docs.currents.dev:

/getting-started/ci-setup/playwright-circleci                200
/getting-started/ci-setup/playwright-azure-devops            200
/getting-started/ci-setup/jenkins                            200
/resources/reporters/currents-cli                            200
/resources/integrations/jira                                 200
/dashboard/projects                                          200
/resources/integrations/http-webhooks                        200
/guides/currents-actions                                     200
/guides/ci-optimization/re-run-only-failed-tests-orchestrated-v2  200
...

YAML parses. All 79 targets exist on disk. No duplicate keys.

Not fixed here — 60 of the 91 docs 404s are a GitBook bug

Two-thirds of the docs 404s are <page>/rss.xml. GitBook emits this on every page:

<link rel="alternate" type="application/rss+xml"
      href="https://docs.currents.dev/guides/record-key/rss.xml" title="RSS Feed"/>

No feed exists at that path, or at /rss.xml. Google follows the link and records a 404, once per page. Nothing in this repo controls that markup — it needs a GitBook support ticket, not a redirect.

🤖 Generated with Claude Code

https://claude.ai/code/session_013vBAvmWyyJsE1eTnxXL2XP


Generated description

Below is a concise technical summary of the changes proposed in this PR:
Add twelve GitBook redirect entries to route remaining hard-404 documentation URLs to their current pages. Update the .gitbook.yaml redirect configuration to cover relocated CI setup, integration, dashboard, reporter, and guide content while preserving existing source files.

TopicDetails
Product page redirects Redirect remaining top-level product pages such as projects, webhooks, and actions to their current dashboard, integration, and guide locations.
Modified files (1)
  • .gitbook.yaml
Latest Contributors(2)
UserCommitDate
agoldis@users.noreply....Fix broken redirects a...August 08, 2026
agoldis@gmail.comAdd redirects for the ...August 08, 2026
Documentation redirects Add redirects for legacy CI setup paths and relocated documentation, including currents-cli, Jira, Cypress compatibility, parallelization, and rerun guides.
Modified files (1)
  • .gitbook.yaml
Latest Contributors(2)
UserCommitDate
agoldis@users.noreply....Fix broken redirects a...August 08, 2026
agoldis@gmail.comAdd redirects for the ...August 08, 2026
Review this PR on Baz | Customize your next review

Summary by CodeRabbit

  • Documentation
    • Added redirects for updated documentation paths covering integrations, CLI usage, Cypress, reruns, Jira, projects, webhooks, and automation workflows.

@coderabbitai

coderabbitai Bot commented Aug 8, 2026

Copy link
Copy Markdown

Review Change Stack

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 0cf4508f-3ee4-47df-9b4e-5cf1bb44ff3c

📥 Commits

Reviewing files that changed from the base of the PR and between f47fa3d and beadfd0.

📒 Files selected for processing (1)
  • .gitbook.yaml

📝 Walkthrough

Walkthrough

Added twelve GitBook redirects for CI integrations, CLI and Cypress documentation, rerun orchestration, Jira, projects, webhooks, and Currents Actions.

Changes

Documentation redirects

Layer / File(s) Summary
Add GitBook redirect mappings
.gitbook.yaml
Added twelve redirects for the updated documentation paths.

Estimated code review effort: 1 (Trivial) | ~2 minutes

Possibly related PRs

Suggested labels: baz approved

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/redirect-map-gaps

Comment @coderabbitai help to get the list of available commands.

Base automatically changed from fix/broken-links-and-redirects to main August 8, 2026 08:12
Search Console lists 91 crawled 404s on docs.currents.dev. #63 covers ten
of the ones that are real page moves; these twelve are the remainder,
including every path still reachable from currents.dev/readme/*.

Four are bare CI-provider paths (ci-setup/circleci, ci-setup/azure-devops,
ci-setup/bitbucket, ci-setup/jenkins-playwright) that predate flattening
the ci-setup tree. Files with those names still exist at the repo root but
are absent from SUMMARY.md, so GitBook does not serve them — hence the
404. Adding redirects is additive and leaves those files alone; whether
the unlisted ci-setup/ directory should exist at all is a separate
question.

The rest are single pages that moved section: currents-cli to
resources/reporters, jira to resources/integrations, currents-actions and
the orchestrated re-run guide to their current homes.

Every target verified to return 200 on docs.currents.dev, and every target
file verified to exist on disk. 79 entries total, no duplicate keys.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013vBAvmWyyJsE1eTnxXL2XP
@agoldis
agoldis force-pushed the fix/redirect-map-gaps branch from 4af2f1e to beadfd0 Compare August 8, 2026 08:13
@agoldis
agoldis merged commit fc3ef97 into main Aug 8, 2026
3 of 4 checks passed
@agoldis
agoldis deleted the fix/redirect-map-gaps branch August 8, 2026 08:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant