Skip to content

fix/links: Replace or remove dead external links - #1999

Draft
marcleblanc2 wants to merge 1 commit into
mainfrom
marc/fix/dead-external-links
Draft

marcleblanc2 wants to merge 1 commit into
mainfrom
marc/fix/dead-external-links

Conversation

@marcleblanc2

Copy link
Copy Markdown
Contributor

Problem

The audit probed every external link on the site. sourcegraph.com no longer serves public repositories (sourcegraph.com/github.com/... is a 404), docs-legacy.sourcegraph.com and about.sourcegraph.com are gone, and a number of vendor pages moved.

Fix

  • sourcegraph.com/github.com/<repo> links point at github.com (same ref/path where one was pinned)
  • docs-legacy developer-docs links are unlinked (no public replacement) or pointed at the current page on this site
  • vendor links (AWS, DigitalOcean, PostgreSQL, eksctl, EnterpriseDB, git date formats) follow their redirects to the current URL
  • links with no replacement (GitHub issue forms, help-center article, Bitbucket settings page, Gitpod blog, two dead images, the Cody for Web card) are unlinked or removed
  • http:// links to hosts that serve https get https

Deliberately not touched here: contact/sales and the other about.sourcegraph.com links (separate PR: fix/links: Point sales links at sourcegraph.com/contact/request-info), the technical changelog, hosts that block bots, and placeholder URLs.

Verification

Every changed line passes pnpm run check links --check-anchors --check-self-links --check-external --diff <(git diff -U0 origin/main); every replacement URL was also curled by hand with a browser UA.

URL table
File Dead URL Replacement
docs/admin/audit-log.mdx https://docs-legacy.sourcegraph.com/dev/how-to/add_logging (unlinked / removed)
docs/admin/auth/login-form.mdx https://sourcegraphstatic.com/docs/images/administration/auth/login_form_order.png (unlinked / removed)
docs/admin/code-hosts/bitbucket-cloud.mdx https://bitbucket.org/account/settings (unlinked / removed)
docs/admin/security-event-logs.mdx https://docs-legacy.sourcegraph.com/dev/how-to/add_logging (unlinked / removed)
docs/batch-changes/design.mdx https://github.com/kubernetes/community/blob/master/contributors/design-proposals/architecture/architecture (unlinked / removed)
docs/batch-changes/faq.mdx https://help.sourcegraph.com/hc/en-us/articles/28471221973133-Changing-Ownership-Of-A-Batch-Change-Before-User-Deletion (unlinked / removed)
docs/batch-changes/faq.mdx https://github.com/sourcegraph/batch-change-examples/blob/main/ticketing-systems/jira-tickets/README https://github.com/sourcegraph/batch-change-examples/blob/main/ticketing-systems/jira-tickets/README.md
docs/batch-changes/faq.mdx https://github.com/sourcegraph/batch-change-examples/blob/main/ticketing-systems/github-issues/README https://github.com/sourcegraph/batch-change-examples/blob/main/ticketing-systems/github-issues/README.md
docs/batch-changes/how-src-executes-a-batch-spec.mdx https://github.com/sourcegraph/src-cli/blob/main/schema/batch_spec.schema.json (unlinked / removed)
docs/cloud/index.mdx https://about.sourcegraph.com/terms-private https://sourcegraph.com/terms/cloud
docs/code-insights/references/repository-scope.mdx https://storage.googleapis.com/sourcegraph-assets/docs/images/code-insights/create_insight_repo_selection.png (unlinked / removed)
docs/code-navigation/how-to/adding-scip-to-workflows.mdx https://about.sourcegraph.com/terms-dotcom#3-proprietary-rights-and-licenses https://sourcegraph.com/terms#3-proprietary-rights-and-licenses
docs/code-navigation/precise-code-navigation.mdx https://sourcegraph.github.io/scip-java/docs/getting-started.html https://github.com/sourcegraph/scip-java
docs/code-navigation/precise-code-navigation.mdx https://sourcegraph.com/github.com/sourcegraph/scip-python https://github.com/sourcegraph/scip-python
docs/code-navigation/precise-code-navigation.mdx https://sourcegraph.com/github.com/sourcegraph/scip-ruby https://github.com/sourcegraph/scip-ruby
docs/code-navigation/precise-code-navigation.mdx https://sourcegraph.com/github.com/sourcegraph/scip-go https://github.com/sourcegraph/scip-go
docs/code-navigation/precise-code-navigation.mdx https://sourcegraph.com/github.com/sourcegraph/scip-typescript https://github.com/sourcegraph/scip-typescript
docs/code-navigation/precise-code-navigation.mdx https://sourcegraph.com/github.com/sourcegraph/scip-clang https://github.com/sourcegraph/scip-clang
docs/code-navigation/precise-code-navigation.mdx https://sourcegraph.com/github.com/sourcegraph/scip-java https://github.com/sourcegraph/scip-java
docs/code-navigation/precise-code-navigation.mdx https://sourcegraph.com/github.com/rust-lang/rust-analyzer https://github.com/rust-lang/rust-analyzer
docs/code-navigation/precise-code-navigation.mdx https://sourcegraph.com/github.com/sourcegraph/scip-python https://github.com/sourcegraph/scip-python
docs/code-navigation/precise-code-navigation.mdx https://sourcegraph.com/github.com/sourcegraph/scip-ruby https://github.com/sourcegraph/scip-ruby
docs/code-navigation/private-maven-repository-configuration.mdx https://sourcegraph.github.io/scip-java/ https://github.com/sourcegraph/scip-java
docs/code-navigation/private-maven-repository-configuration.mdx https://sourcegraph.github.io/scip-java/ https://github.com/sourcegraph/scip-java
docs/code-navigation/writing-an-indexer.mdx https://sourcegraph.com/github.com/sourcegraph/scip@12459c75fc15117e68b4c15a58e8581b738b855f/-/blob/scip.proto?L87-115 https://github.com/sourcegraph/scip/blob/12459c75fc15117e68b4c15a58e8581b738b855f/scip.proto#L87-L115
docs/code-navigation/writing-an-indexer.mdx https://sourcegraph.github.io/scip-java/docs/getting-started.html https://github.com/sourcegraph/scip-java
docs/code-search/how-to/opengrok.mdx https://about.sourcegraph.com/workflow (unlinked / removed)
docs/code-search/queries/language.mdx https://github.com/git/git/blob/master/Documentation/date-formats.txt https://github.com/git/git/blob/master/Documentation/date-formats.adoc
docs/cody/clients/cody-with-sourcegraph.mdx https://sourcegraph.com/cody/chat (unlinked / removed)
docs/cody/clients/cody-with-sourcegraph.mdx https://storage.googleapis.com/sourcegraph-assets/Docs/sg-new-logo.svg (unlinked / removed)
docs/cody/clients/install-neovim.mdx https://github.com/sourcegraph/cody (unlinked / removed)
docs/cody/faq.mdx https://www.gitpod.io/blog/boosting-developer-productivity-unleashing-the-power-of-sourcegraph-cody-in-gitpod (unlinked / removed)
docs/cody/faq.mdx http://ampcode.com/ https://ampcode.com/
docs/cody/faq.mdx http://ampcode.com https://ampcode.com/
docs/cody/faq.mdx http://ampcode.com https://ampcode.com/
docs/cody/faq.mdx https://discord.com/servers/sourcegraph-969688426372825169 https://discord.gg/s2qDtYGnAE
docs/getting-started/github-vs-sourcegraph.mdx https://docs-legacy.sourcegraph.com/dev/background-information/architecture/indexed-ranking (unlinked / removed)
docs/getting-started/github-vs-sourcegraph.mdx https://github.com/features/code-search-code-view/signup (unlinked / removed)
docs/integration/bitbucket-server.mdx https://github.com/sourcegraph/bitbucket-server-plugin/blob/master/src/main/java/com/sourcegraph/webhook/README https://github.com/sourcegraph/bitbucket-server-plugin/blob/master/src/main/java/com/sourcegraph/webhook/README.md
docs/integration/gitlab.mdx https://about.sourcegraph.com/guides/sourcegraph-gitlab-solution-brief.pdf (unlinked / removed)
docs/integration/gitolite.mdx http://gitolite.com/ https://gitolite.com/
docs/integration/gitpod.mdx https://www.gitpod.io/docs/ides-and-editors/jetbrains-gateway#jetbrains-ide-support (unlinked / removed)
docs/pricing/faqs.mdx https://sourcegraph.netlify.app/security https://sourcegraph.com/security
docs/self-hosted/deploy/docker-compose/digitalocean.mdx https://www.digitalocean.com/docs/networking/firewalls/quickstart/ https://docs.digitalocean.com/products/networking/firewalls/getting-started/quickstart/
docs/self-hosted/deploy/kubernetes/configure.mdx https://sourcegraph.com/github.com/sourcegraph/deploy-sourcegraph-k8s@master/-/tree/base/otel-collector/otel-collector.ConfigMap.yaml https://github.com/sourcegraph/deploy-sourcegraph-k8s/blob/main/base/monitoring/otel-collector/otel-collector.ConfigMap.yaml
docs/self-hosted/deploy/kubernetes/configure.mdx https://sourcegraph.com/github.com/sourcegraph/deploy-sourcegraph-k8s/-/tree/components/resources/namespace https://github.com/sourcegraph/deploy-sourcegraph-k8s/tree/main/components/resources/namespace
docs/self-hosted/deploy/kubernetes/configure.mdx https://sourcegraph.com/github.com/sourcegraph/deploy-sourcegraph-k8s/-/tree/components/storage-class/aws/eks https://github.com/sourcegraph/deploy-sourcegraph-k8s/tree/main/components/storage-class/aws/ebs-csi
docs/self-hosted/deploy/kubernetes/configure.mdx https://sourcegraph.com/github.com/sourcegraph/deploy-sourcegraph-k8s/-/tree/components/storage-class/aws/ebs https://github.com/sourcegraph/deploy-sourcegraph-k8s/tree/main/components/storage-class/aws/aws-ebs
docs/self-hosted/deploy/kubernetes/configure.mdx https://sourcegraph.com/github.com/sourcegraph/deploy-sourcegraph-k8s/-/tree/components/storage-class/aws/eks https://github.com/sourcegraph/deploy-sourcegraph-k8s/tree/main/components/storage-class/aws/ebs-csi
docs/self-hosted/deploy/kubernetes/configure.mdx https://sourcegraph.com/github.com/sourcegraph/deploy-sourcegraph-k8s/-/tree/components/storage-class/aws/ebs https://github.com/sourcegraph/deploy-sourcegraph-k8s/tree/main/components/storage-class/aws/aws-ebs
docs/self-hosted/deploy/kubernetes/configure.mdx http://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_SecurityGroups.html https://docs.aws.amazon.com/vpc/latest/userguide/vpc-security-groups.html
docs/self-hosted/deploy/kubernetes/configure.mdx https://docs.ranchermanager.rancher.io/v2.0-v2.4/how-to-guides/new-user-guides/migrate-from-v1.6-v2.x/expose-services#nodeport
https://sourcegraph.com/github.com/sourcegraph/deploy-sourcegraph-k8s/-/tree/components/network/nodeport/custom
https://github.com/sourcegraph/deploy-sourcegraph-k8s/tree/main/components/network/nodeport/custom
docs/self-hosted/deploy/kubernetes/configure.mdx http://www.postgresql.org/docs/current/static/libpq-envars.html https://www.postgresql.org/docs/current/libpq-envars.html
docs/self-hosted/deploy/kubernetes/configure.mdx https://sourcegraph.com/github.com/sourcegraph/deploy-sourcegraph-k8s/-/tree/components/privileged https://github.com/sourcegraph/deploy-sourcegraph-k8s/tree/main/components/privileged
docs/self-hosted/deploy/kubernetes/configure.mdx https://sourcegraph.com/github.com/sourcegraph/deploy-sourcegraph-k8s/-/tree/components/enable/ssh/root https://github.com/sourcegraph/deploy-sourcegraph-k8s/tree/main/components/enable/ssh/root
docs/self-hosted/deploy/kubernetes/configure.mdx https://docs-legacy.sourcegraph.com/dev/background-information/observability/cadvisor#known-issues (unlinked / removed)
docs/self-hosted/deploy/kubernetes/configure.mdx http://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_Internet_Gateway.html https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Internet_Gateway.html
docs/self-hosted/deploy/kubernetes/eks.mdx https://eksctl.io/introduction/#installation https://eksctl.io/getting-started/
docs/self-hosted/deploy/kubernetes/kustomize.mdx https://docs.sourcegraph.com/@v4.4.2/admin/deploy/kubernetes (unlinked / removed)
docs/self-hosted/deploy/kubernetes/kustomize/index.mdx https://docs.sourcegraph.com/@v4.4.2/admin/deploy/kubernetes (unlinked / removed)
docs/self-hosted/deploy/kubernetes/scale.mdx https://docs-legacy.sourcegraph.com/dev/background-information/architecture (unlinked / removed)
docs/self-hosted/deploy/machine-images/index.mdx https://sourcegraph.com/github.com/sourcegraph/deploy https://github.com/sourcegraph/deploy
docs/self-hosted/deploy/machine-images/index.mdx https://sourcegraph.com/github.com/sourcegraph/deploy@v4.0.1/-/blob/doc/development.md https://github.com/sourcegraph/deploy/blob/v4.0.1/doc/development.md
docs/self-hosted/deploy/machine-images/index.mdx https://sourcegraph.com/github.com/sourcegraph/deploy-sourcegraph-helm https://github.com/sourcegraph/deploy-sourcegraph-helm
docs/self-hosted/deploy/machine-images/index.mdx https://sourcegraph.com/github.com/k3s-io/k3s#what-is-this https://github.com/k3s-io/k3s#what-is-this
docs/self-hosted/deploy/machine-images/index.mdx https://sourcegraph.com/github.com/sourcegraph/deploy@v5.2.5/-/blob/install/reboot.sh https://github.com/sourcegraph/deploy/blob/v5.2.5/install/reboot.sh
docs/self-hosted/deploy/machine-images/index.mdx https://sourcegraph.com/github.com/sourcegraph/deploy@v4.0.1/-/blob/install/install.sh https://github.com/sourcegraph/deploy/blob/v4.0.1/install/install.sh
docs/self-hosted/deploy/machine-images/index.mdx https://sourcegraph.com/github.com/sourcegraph/deploy@v4.0.1/-/blob/install/install.sh?L64-73 https://github.com/sourcegraph/deploy/blob/v4.0.1/install/install.sh#L64-L73
docs/self-hosted/deploy/machine-images/index.mdx https://sourcegraph.com/github.com/sourcegraph/deploy@v4.0.1/-/blob/install/install.sh?L78-84 https://github.com/sourcegraph/deploy/blob/v4.0.1/install/install.sh#L78-L84
docs/self-hosted/deploy/machine-images/index.mdx https://sourcegraph.com/github.com/sourcegraph/deploy@v4.0.1/-/blob/install/reboot.sh https://github.com/sourcegraph/deploy/blob/v4.0.1/install/reboot.sh
docs/self-hosted/deploy/machine-images/index.mdx https://sourcegraph.com/github.com/sourcegraph/deploy https://github.com/sourcegraph/deploy
docs/self-hosted/deploy/machine-images/index.mdx https://sourcegraph.com/github.com/sourcegraph/deploy@v4.0.1/-/blob/install/install.sh https://github.com/sourcegraph/deploy/blob/v4.0.1/install/install.sh
docs/self-hosted/deploy/machine-images/index.mdx https://sourcegraph.com/github.com/sourcegraph/deploy@v4.0.1/-/blob/doc/development.md https://github.com/sourcegraph/deploy/blob/v4.0.1/doc/development.md
docs/self-hosted/deploy/scale.mdx https://docs-legacy.sourcegraph.com/dev/background-information/observability/cadvisor#known-issues (unlinked / removed)
docs/self-hosted/external-services/postgres.mdx http://www.postgresql.org/docs/current/static/libpq-envars.html https://www.postgresql.org/docs/current/libpq-envars.html
docs/self-hosted/external-services/postgres.mdx https://docs-legacy.sourcegraph.com/dev/background-information/sql/migrations (unlinked / removed)
docs/self-hosted/observability/alerts.mdx https://github.com/sourcegraph/sourcegraph/issues/new/choose (unlinked / removed)
docs/self-hosted/observability/alerts.mdx https://github.com/sourcegraph/sourcegraph/issues/new?assignees=&labels=&template=bug_report.md&title= (unlinked / removed)
docs/self-hosted/observability/alerts.mdx https://github.com/sourcegraph/sourcegraph/issues/new?assignees=&labels=&template=bug_report.md&title= (unlinked / removed)
docs/self-hosted/observability/logs.mdx https://docs-legacy.sourcegraph.com/dev/how-to/add_logging/dev/how-to/add_logging (unlinked / removed)
docs/self-hosted/observability/troubleshooting.mdx https://gist.githubusercontent.com/slimsag/3fcc134f5ce09728188b94b463131527/raw/f8b545f4ce14b0c30a93f05cd1ee469594957a2c/sourcegraph-debug-search-timeouts.json (unlinked / removed)
docs/self-hosted/postgres.mdx https://www.enterprisedb.com/docs/en/9.6/pg/upgrading.html https://www.enterprisedb.com/docs/pgd/latest/upgrades/
docs/self-hosted/postgres.mdx http://docs.citusdata.com/en/v8.1/admin_guide/upgrading_citus.html https://docs.citusdata.com/en/v8.1/admin_guide/upgrading_citus.html
docs/self-hosted/updates/index.mdx https://docs-legacy.sourcegraph.com/dev/background-information/sql/migrations_overview (unlinked / removed)
docs/self-hosted/updates/index.mdx https://docs-legacy.sourcegraph.com/dev/background-information/sql/migrations_overview#out-of-band-migrations (unlinked / removed)
docs/self-hosted/url.mdx http://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_Internet_Gateway.html https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Internet_Gateway.html

Found by the docs site audit in this Amp thread; rebuilt locally in this one.

The docs site audit probed every external link. sourcegraph.com no
longer serves public repositories (sourcegraph.com/github.com/... is a
404), docs-legacy.sourcegraph.com and about.sourcegraph.com are gone,
and a number of vendor pages have moved.

- sourcegraph.com/github.com/<repo> links now point at github.com
- docs-legacy links to developer docs are unlinked (no public
  replacement) or pointed at the current page on this site
- vendor links (AWS, DigitalOcean, PostgreSQL, eksctl, EnterpriseDB,
  git date formats) follow their redirects to the current URL
- links with no replacement (GitHub issue forms, help-center article,
  Bitbucket settings, Gitpod blog, dead images, Cody for Web card) are
  unlinked or removed
- http:// links to hosts that serve https get https

Every changed line passes check-links --check-external.

Found by the docs site audit in
https://ampcode.com/threads/T-01a0ae50-f7f0-779c-aa66-3887c9953e33

Co-authored-by: Amp <amp@ampcode.com>
Amp-Thread-ID: https://ampcode.com/threads/T-01a0aed2-5fbe-7768-85ea-1378bf98f9ff
@vercel

vercel Bot commented Sep 17, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
sourcegraph-docs Ready Ready Preview Sep 17, 2026 10:43am UTC

Request Review

@github-actions

Copy link
Copy Markdown
Contributor

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