Skip to content

Point stale docs.sourcegraph.com links at sourcegraph.com/docs - #1364

Merged
bahrmichael merged 3 commits into
mainfrom
docs-url-rewrite-88cfd6e5-d8f4-47ad-a67e-f9286a430b5a
Sep 4, 2026
Merged

Point stale docs.sourcegraph.com links at sourcegraph.com/docs#1364
bahrmichael merged 3 commits into
mainfrom
docs-url-rewrite-88cfd6e5-d8f4-47ad-a67e-f9286a430b5a

Conversation

@bahrmichael

Copy link
Copy Markdown
Contributor

docs.sourcegraph.com is no longer the docs host. This rewrites the remaining absolute references to their sourcegraph.com/docs equivalents.

The rewrite is purely mechanical — only the host portion changes (docs.sourcegraph.com/<path> becomes sourcegraph.com/docs/<path>). Paths that were reorganised since (for example admin/observability/tracing and batch_changes/references/troubleshooting) are already covered by permanent redirects in the docs site's redirect map, so the rewritten links resolve.

In src-cli, CHANGELOG.md is deliberately left alone: those entries are a historical record. In the docs repo the change is scoped to docs/cli/references/**, which is generated from src-cli by src doc — the companion src-cli changeset fixes the generator's source strings so the docs stay correct after the next regeneration.

Created by a Sourcegraph agentic batch change.

@bahrmichael
bahrmichael marked this pull request as ready for review September 3, 2026 12:12
@bahrmichael
bahrmichael enabled auto-merge (squash) September 3, 2026 12:13

@keegancsmith keegancsmith left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approving to unblock. I checked all nine distinct rewritten URLs in a browser: five reach the intended docs pages, while four render the docs site’s soft-404 page despite returning HTTP 200. I left non-blocking inline notes on those four links.

Comment thread DEVELOPMENT.md Outdated
Comment thread README.md Outdated
Comment thread internal/users/admin.go Outdated
@bahrmichael

Copy link
Copy Markdown
Contributor Author

Thanks @keegancsmith ! I'll go through those tomorrow :)

bahrmichael and others added 2 commits September 4, 2026 09:22
The testing principles, Go testing, telemetry, and CSRF security model
pages no longer exist on sourcegraph.com/docs. Replace the links with
plain text and inline the relevant context in the code comment.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@bahrmichael
bahrmichael merged commit 0adbf30 into main Sep 4, 2026
8 checks passed
@bahrmichael
bahrmichael deleted the docs-url-rewrite-88cfd6e5-d8f4-47ad-a67e-f9286a430b5a branch September 4, 2026 11:03
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.

2 participants