Skip to content

Update links identified by the external links checker

Following up on #436 (closed), and #394 (closed) before that, we need to continue to keep the external links up to date as they get stale.

As external sites update their architecture, things get redirected, deleted, etc... and we want to make sure we don't have dead links in the docs. At the same time, redirected links aren't necessarily bad, but we want to make sure we aren't redirecting to a page that no longer lists the information, so it's good to update the redirected links as well. See previous issues and MRs for examples.

Note that this may require a fair amount of digging sometimes, especially for 404'ing links, to find the correct new location, or perhaps the location is completely gone, and then we have to decide what to do about the doc (find a new source of information, remove the link and update the content, other).

As a result, we should keep these MRs a little smaller. Perhaps 10-15 links per MR, if possible, though there is plenty of flexibility on that. Be sure to:

  • Group topics together, and assign MRs to the TW for that topic. Use https://about.gitlab.com/handbook/product/categories/ as a reference.
  • Label with: Technical Writing documentation ~backstage, and the stage (devops:: ) and group (group:: ) labels.
  • Link the MR to this issue by adding Related to in the MR description.
  • Prioritize fixing 404'ing links, and links within your current/future stages/groups.
  • Make a comment to point out which links/dirs you are working on. Feel free to edit the list to remove fixed links once your MR has been merged.

List of errors, taken from a local run of check_external_links test on master on c3c5b3131ca on 2020-04-03.

ALL errors
  • An error repeated a lot: 
    [ ERROR ] external_links - broken reference to https://www.facebook.com/gitlab: SSL_read: unexpected eof while reading
  Running check external_links…   error
Issues found!
  public/404.html:
    [ ERROR ] external_links - broken reference to https://docs.gitlab.com/omnibus: 404
  public/charts/installation/cloud/eks.html:
    [ ERROR ] external_links - broken reference to https://gitlab.com/gitlab-org/gitlab/-/issues/29566: 404
  public/ee/administration/instance_review.html:
    [ ERROR ] external_links - broken reference to https://selenium.dev/: link has moved permanently to 'https://www.selenium.dev/'
  public/ee/ci/examples/laravel_with_gitlab_and_envoy/index.html:
    [ ERROR ] external_links - broken reference to https://gitlab.com/gitlab-org/customers-gitlab-com/issues/414: 404
  public/ee/ci/junit_test_reports.html:
    [ ERROR ] external_links - broken reference to https://graphql-ruby.org/queries/analysis.html: 404
    [ ERROR ] external_links - broken reference to https://gitlab.com/gitlab-org/create-stage/issues/1: 404
  public/ee/development/api_styleguide.html:
    [ ERROR ] external_links - broken reference to https://github.com/getsentry/sentry/blob/master/README.rst: 404
  public/ee/development/auto_devops.html:
    [ ERROR ] external_links - broken reference to https://gitlab.com/gitlab-org/create-stage/issues/1: 404
  public/ee/development/distributed_tracing.html:
    [ ERROR ] external_links - broken reference to http://nanoc.ws: link has moved permanently to 'https://nanoc.ws/'
  public/ee/development/documentation/site_architecture/release_process.html:
    [ ERROR ] external_links - broken reference to https://gitlab.com/gitlab-org/gitlab-docs/-/environments/folders/registry: 404
  public/ee/development/documentation/structure.html:
    [ ERROR ] external_links - broken reference to https://www2.le.ac.uk/offices/ld/resources/writing/grammar/grammar-guides/sentence: link has moved permanently to 'https://www2.le.ac.uk/offices/ld/all-resources/writing/grammar/grammar-guides/sentence'
  public/ee/development/documentation/workflow.html:
    [ ERROR ] external_links - broken reference to https://gitlab.com/gitlab-org/create-stage/issues/1: 404
  public/ee/development/emails.html:
    [ ERROR ] external_links - broken reference to https://github.com/apollographql/apollo-client/tree/master/packages/apollo-cache-inmemory: 404
    [ ERROR ] external_links - broken reference to https://github.com/Akryum/vue-apollo/: link has moved permanently to 'https://github.com/vuejs/vue-apollo'
  public/ee/development/fe_guide/icons.html:
    [ ERROR ] external_links - broken reference to https://github.com/brigade/scss-lint: link has moved permanently to 'https://github.com/sds/scss-lint'
  public/ee/development/fe_guide/performance.html:
    [ ERROR ] external_links - broken reference to https://github.com/brigade/scss-lint: link has moved permanently to 'https://github.com/sds/scss-lint'
  public/ee/development/fe_guide/style/javascript.html:
    [ ERROR ] external_links - broken reference to https://gitlab.com/gitlab-org/create-stage/issues/1: 404
  public/ee/development/github_importer.html:
    [ ERROR ] external_links - broken reference to https://gitlab.com/gitlab-org/quality/performance-data/raw/master/gitlabhq_export.tar.gz: 404
    [ ERROR ] external_links - broken reference to https://gitlab.com/gitlab-org/gitlab/snippets/1924954: 404
  public/ee/development/insert_into_tables_in_batches.html:
    [ ERROR ] external_links - broken reference to https://access.redhat.com/errata: link has moved permanently to 'https://access.redhat.com/errata/'
  public/ee/development/integrations/secure_partner_integration.html:
    [ ERROR ] external_links - broken reference to https://gitlab.com/gitlab-org/create-stage/issues/1: 404
  public/ee/development/licensed_feature_availability.html:
    [ ERROR ] external_links - broken reference to https://plot.ly/: link has moved permanently to 'https://plotly.com/'
  public/ee/development/new_fe_guide/development/index.html:
    [ ERROR ] external_links - broken reference to https://gitlab-org.gitlab.io/gitlab/coverage-ruby/: 404
    [ ERROR ] external_links - broken reference to https://gitlab-org.gitlab.io/gitlab/webpack-report/: 404
    [ ERROR ] external_links - broken reference to https://gitlab-org.gitlab.io/gitlab/coverage-javascript/: 404
  public/ee/development/policies.html:
    [ ERROR ] external_links - broken reference to https://gitlab.com/gitlab-org/create-stage/issues/1: 404
  public/ee/development/reusing_abstractions.html:
    [ ERROR ] external_links - broken reference to https://gitlab-org.gitlab.io/gitlab/coverage-ruby/: 404
  public/ee/development/testing_guide/end_to_end/resources.html:
    [ ERROR ] external_links - broken reference to http://semaphoreci.com/blog/2017/08/03/tips-on-treating-flakiness-in-your-test-suite.html: link has moved permanently to 'https://semaphoreci.com/blog/2017/08/03/tips-on-treating-flakiness-in-your-test-suite.html'
    [ ERROR ] external_links - broken reference to http://semaphoreci.com/blog/2017/04/20/flaky-tests.html: link has moved permanently to 'https://semaphoreci.com/blog/2017/04/20/flaky-tests.html'
  public/ee/development/testing_guide/frontend_testing.html:
    [ ERROR ] external_links - broken reference to http://tatiyants.com/postgres-query-plan-visualization/: 406
  public/ee/development/uploads.html:
    [ ERROR ] external_links - broken reference to http://tetraph.com/covert_redirect/: 502
  public/ee/integration/cas.html:
    [ ERROR ] external_links - broken reference to http://docs.aws.amazon.com/elasticsearch-service/latest/developerguide/es-gsg.html: link has moved permanently to 'https://docs.aws.amazon.com/elasticsearch-service/latest/developerguide/es-gsg.html'
    [ ERROR ] external_links - broken reference to https://www.elastic.co/products/elasticsearch/service: link has moved permanently to 'https://www.elastic.co/elasticsearch/service'
  public/ee/integration/external-issue-tracker.html:
    [ ERROR ] external_links - broken reference to https://developers.facebook.com/: SSL_read: unexpected eof while reading
  public/ee/integration/github.html:
    [ ERROR ] external_links - broken reference to http://tetraph.com/covert_redirect/: 502
  public/ee/integration/gitlab.html:
    [ ERROR ] external_links - broken reference to https://www.salesforce.com/: link has moved permanently to 'https://www.salesforce.com/eu/?ir=1'
  public/ee/integration/saml.html:
    [ ERROR ] external_links - broken reference to https://ultraauth.com: 525
  public/ee/integration/vault.html:
    [ ERROR ] external_links - broken reference to https://www.vaultproject.io/docs/auth/jwt.html: 404
  public/ee/intro/README.html:
    [ ERROR ] external_links - broken reference to https://github.com/plataformatec/devise: link has moved permanently to 'https://github.com/heartcombo/devise'
  public/ee/security/rack_attack.html:
    [ ERROR ] external_links - broken reference to https://github.com/coreos/clair: link has moved permanently to 'https://github.com/quay/clair'
  public/ee/topics/autodevops/quick_start_guide.html:
    [ ERROR ] external_links - broken reference to https://puppet.com/resources/whitepaper/2016-state-of-devops-report: link has moved permanently to 'https://puppet.com/resources/report/2016-state-devops-report/'
    [ ERROR ] external_links - broken reference to https://about.gitlab.com/stages-devops-lifecycle/cycle-analytics/: link has moved permanently to 'https://about.gitlab.com/stages-devops-lifecycle/value-stream-analytics/'
    [ ERROR ] external_links - broken reference to https://cdixon.org/2014/04/13/software-eats-software-development: link has moved permanently to 'https://cdixon.org/2014/04/13/software-eats-software-development/'
  public/ee/university/bookclub/booklist.html:
    [ ERROR ] external_links - broken reference to https://yarnpkg.com/en/docs/install: link has moved permanently to 'https://classic.yarnpkg.com/en/docs/install'
  public/ee/update/upgrading_postgresql_using_slony.html:
    [ ERROR ] external_links - broken reference to http://www.slony.info/: link has moved permanently to 'https://www.slony.info/'
  public/ee/user/abuse_reports.html:
    [ ERROR ] external_links - broken reference to https://about.gitlab.com/stages-devops-lifecycle/cycle-analytics/: link has moved permanently to 'https://about.gitlab.com/stages-devops-lifecycle/value-stream-analytics/'
  public/ee/user/application_security/compliance_dashboard/index.html:
    [ ERROR ] external_links - broken reference to https://github.com/coreos/clair: link has moved permanently to 'https://github.com/quay/clair'
    [ ERROR ] external_links - broken reference to https://cloud.docker.com/repository/docker/arminc/clair-db: link has moved permanently to 'https://hub.docker.com/repository/docker/arminc/clair-db'
  public/ee/user/application_security/dast/index.html:
    [ ERROR ] external_links - broken reference to https://poetry.eustace.io/: link has moved permanently to 'http://python-poetry.org/'
    [ ERROR ] external_links - broken reference to https://yarnpkg.com/en/: link has moved permanently to 'https://classic.yarnpkg.com/en/'
  public/ee/user/application_security/index.html:
    [ ERROR ] external_links - broken reference to https://github.com/crossplaneio/crossplane/blob/master/cluster/charts/crossplane/values.yaml.tmpl: link has moved permanently to 'https://github.com/crossplane/crossplane/blob/master/cluster/charts/crossplane/values.yaml.tmpl'
    [ ERROR ] external_links - broken reference to https://charts.crossplane.io/alpha/: 404
    [ ERROR ] external_links - broken reference to https://www.elastic.co/products/elastic-stack: link has moved permanently to 'https://www.elastic.co/elastic-stack'
    [ ERROR ] external_links - broken reference to https://vaultproject.io/: link has moved permanently to 'https://www.vaultproject.io/'
    [ ERROR ] external_links - broken reference to https://crossplane.io/docs: link has moved permanently to 'https://crossplane.github.io/docs/'
  public/ee/user/clusters/crossplane.html:
    [ ERROR ] external_links - broken reference to https://crates.io: 404
  public/ee/user/discussions/index.html:
    [ ERROR ] external_links - broken reference to https://docs.microsoft.com/en-us/azure/active-directory/manage-apps/use-scim-to-provision-users-and-groups: link has moved permanently to 'https://docs.microsoft.com/en-us/azure/active-directory/app-provisioning/use-scim-to-provision-users-and-groups'
  public/ee/user/group/security_dashboard/index.html:
    [ ERROR ] external_links - broken reference to https://www.rubydoc.info/gems/html-pipeline/1.11.0/HTML/Pipeline/SanitizationFilter: 404
    [ ERROR ] external_links - broken reference to https://help.github.com/en/articles/basic-writing-and-formatting-syntax: link has moved permanently to 'https://help.github.com/en/github/writing-on-github/basic-writing-and-formatting-syntax'
    [ ERROR ] external_links - broken reference to http://try.commonmark.org: Failed to open TCP connection to try.commonmark.org:80 (Connection refused - connect(2) for "try.commonmark.org" port 80)
  public/ee/user/operations_dashboard/index.html:
    [ ERROR ] external_links - broken reference to https://yarnpkg.com/en/: link has moved permanently to 'https://classic.yarnpkg.com/en/'
    [ ERROR ] external_links - broken reference to https://yarnpkg.com/en/docs/install: link has moved permanently to 'https://classic.yarnpkg.com/en/docs/install'
  public/ee/user/packages/nuget_repository/index.html:
    [ ERROR ] external_links - broken reference to https://www.yubico.com/products/yubikey-hardware/: link has moved permanently to 'https://www.yubico.com/products/'
  public/ee/user/profile/active_sessions.html:
    [ ERROR ] external_links - broken reference to https://github.com/plataformatec/devise: link has moved permanently to 'https://github.com/heartcombo/devise'
  public/ee/user/profile/notifications.html:
    [ ERROR ] external_links - broken reference to https://help.github.com/en/articles/setting-your-commit-email-address: link has moved permanently to 'https://help.github.com/en/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address'
  public/ee/user/project/import/gitlab_com.html:
    [ ERROR ] external_links - broken reference to https://slack.com/help/articles/202035138: too many redirects
  public/ee/user/project/integrations/hangouts_chat.html:
    [ ERROR ] external_links - broken reference to https://docs.microsoft.com/microsoftteams/platform/webhooks-and-connectors/how-to/connectors-using: link has moved permanently to 'https://docs.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/how-to/connectors-using'
  public/ee/user/project/integrations/mock_ci.html:
    [ ERROR ] external_links - broken reference to https://help.shopify.com/en/themes/liquid/basics: link has moved permanently to 'https://shopify.dev/docs/liquid/reference/basics'
  public/ee/user/project/integrations/prometheus_library/cloudwatch.html:
    [ ERROR ] external_links - broken reference to https://about.gitlab.com/stages-devops-lifecycle/cycle-analytics/: link has moved permanently to 'https://about.gitlab.com/stages-devops-lifecycle/value-stream-analytics/'
  public/ee/user/project/issues/csv_export.html:
    [ ERROR ] external_links - broken reference to https://coverage.readthedocs.io/en/coverage-5.0/cmd.html: 404
  public/ee/user/project/merge_requests/versions.html:
    [ ERROR ] external_links - broken reference to https://my.bluehost.com/cgi/help/559: link has moved permanently to 'https://www.bluehost.com/help/article/dns-management-add-edit-or-delete-dns-entries'
  public/ee/user/project/pages/custom_domains_ssl_tls_certification/index.html:
    [ ERROR ] external_links - broken reference to https://gitlab.com/gitlab-org/gitlab-foss/merge_requests/2808: link has moved permanently to 'https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/2808'
  public/ee/user/project/repository/x509_signed_commits/index.html:
    [ ERROR ] external_links - broken reference to https://www.elastic.co/products/elasticsearch: link has moved permanently to 'https://www.elastic.co/elasticsearch'
  public/ee/user/search/advanced_search_syntax.html:
    [ ERROR ] external_links - broken reference to https://docs.okd.io/latest/minishift/getting-started/setting-up-virtualization-environment.html: link has moved permanently to 'http://docs.okd.io/3.11/minishift/getting-started/setting-up-virtualization-environment.html'
    [ ERROR ] external_links - broken reference to https://docs.okd.io/latest/minishift/getting-started/installing.html: link has moved permanently to 'http://docs.okd.io/3.11/minishift/getting-started/installing.html'
  public/omnibus/development/public-attributes.html:
    [ ERROR ] external_links - broken reference to https://about.gitlab.com/install: link has moved permanently to 'https://about.gitlab.com/install/'
  public/runner/best_practice/index.html:
    [ ERROR ] external_links - broken reference to https://about.gitlab.com/blog/2019/12/22/gitlab-12-6-released/: link has moved permanently to 'https://about.gitlab.com/releases/2019/12/22/gitlab-12-6-released/'
    [ ERROR ] external_links - broken reference to https://prometheus.io/docs/prometheus/latest/querying/basics: link has moved permanently to 'https://prometheus.io/docs/prometheus/latest/querying/basics/'
  public/runner/configuration/autoscale.html:
    [ ERROR ] external_links - broken reference to https://about.gitlab.com/product/continuous-integration/: link has moved permanently to 'https://about.gitlab.com/stages-devops-lifecycle/continuous-integration/'
  public/runner/install/autoscaling.html:
Sorted by error and link (deduplicated)

404s

https://charts.crossplane.io/alpha/: 404
https://coverage.readthedocs.io/en/coverage-5.0/cmd.html: 404
https://crates.io: 404
https://docs.gitlab.com/omnibus: 404
https://github.com/apollographql/apollo-client/tree/master/packages/apollo-cache-inmemory: 404
https://github.com/getsentry/sentry/blob/master/README.rst: 404
https://gitlab-org.gitlab.io/gitlab/coverage-javascript/: 404
https://gitlab-org.gitlab.io/gitlab/coverage-ruby/: 404
https://gitlab-org.gitlab.io/gitlab/webpack-report/: 404
https://gitlab.com/gitlab-org/create-stage/issues/1: 404
https://gitlab.com/gitlab-org/customers-gitlab-com/issues/414: 404
https://gitlab.com/gitlab-org/gitlab-docs/-/environments/folders/registry: 404
https://gitlab.com/gitlab-org/gitlab/-/issues/29566: 404
https://gitlab.com/gitlab-org/gitlab/snippets/1924954: 404
https://gitlab.com/gitlab-org/quality/performance-data/raw/master/gitlabhq_export.tar.gz: 404
https://graphql-ruby.org/queries/analysis.html: 404
https://www.rubydoc.info/gems/html-pipeline/1.11.0/HTML/Pipeline/SanitizationFilter: 404
https://www.vaultproject.io/docs/auth/jwt.html: 404

Permanent redirect

http://docs.aws.amazon.com/elasticsearch-service/latest/developerguide/es-gsg.html: link has moved permanently to 'https://docs.aws.amazon.com/elasticsearch-service/latest/developerguide/es-gsg.html'
http://nanoc.ws: link has moved permanently to 'https://nanoc.ws/'
http://semaphoreci.com/blog/2017/04/20/flaky-tests.html: link has moved permanently to 'https://semaphoreci.com/blog/2017/04/20/flaky-tests.html'
http://semaphoreci.com/blog/2017/08/03/tips-on-treating-flakiness-in-your-test-suite.html: link has moved permanently to 'https://semaphoreci.com/blog/2017/08/03/tips-on-treating-flakiness-in-your-test-suite.html'
http://www.slony.info/: link has moved permanently to 'https://www.slony.info/'
https://about.gitlab.com/blog/2019/12/22/gitlab-12-6-released/: link has moved permanently to 'https://about.gitlab.com/releases/2019/12/22/gitlab-12-6-released/'
https://about.gitlab.com/install: link has moved permanently to 'https://about.gitlab.com/install/'
https://about.gitlab.com/product/continuous-integration/: link has moved permanently to 'https://about.gitlab.com/stages-devops-lifecycle/continuous-integration/'
https://about.gitlab.com/stages-devops-lifecycle/cycle-analytics/: link has moved permanently to 'https://about.gitlab.com/stages-devops-lifecycle/value-stream-analytics/'
https://access.redhat.com/errata: link has moved permanently to 'https://access.redhat.com/errata/'
https://cdixon.org/2014/04/13/software-eats-software-development: link has moved permanently to 'https://cdixon.org/2014/04/13/software-eats-software-development/'
https://cloud.docker.com/repository/docker/arminc/clair-db: link has moved permanently to 'https://hub.docker.com/repository/docker/arminc/clair-db'
https://crossplane.io/docs: link has moved permanently to 'https://crossplane.github.io/docs/'
https://docs.microsoft.com/en-us/azure/active-directory/manage-apps/use-scim-to-provision-users-and-groups: link has moved permanently to 'https://docs.microsoft.com/en-us/azure/active-directory/app-provisioning/use-scim-to-provision-users-and-groups'
https://docs.microsoft.com/microsoftteams/platform/webhooks-and-connectors/how-to/connectors-using: link has moved permanently to 'https://docs.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/how-to/connectors-using'
https://docs.okd.io/latest/minishift/getting-started/installing.html: link has moved permanently to 'http://docs.okd.io/3.11/minishift/getting-started/installing.html'
https://docs.okd.io/latest/minishift/getting-started/setting-up-virtualization-environment.html: link has moved permanently to 'http://docs.okd.io/3.11/minishift/getting-started/setting-up-virtualization-environment.html'
https://github.com/Akryum/vue-apollo/: link has moved permanently to 'https://github.com/vuejs/vue-apollo'
https://github.com/brigade/scss-lint: link has moved permanently to 'https://github.com/sds/scss-lint'
https://github.com/coreos/clair: link has moved permanently to 'https://github.com/quay/clair'
https://github.com/crossplaneio/crossplane/blob/master/cluster/charts/crossplane/values.yaml.tmpl: link has moved permanently to 'https://github.com/crossplane/crossplane/blob/master/cluster/charts/crossplane/values.yaml.tmpl'
https://github.com/plataformatec/devise: link has moved permanently to 'https://github.com/heartcombo/devise'
https://gitlab.com/gitlab-org/gitlab-foss/merge_requests/2808: link has moved permanently to 'https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/2808'
https://help.github.com/en/articles/basic-writing-and-formatting-syntax: link has moved permanently to 'https://help.github.com/en/github/writing-on-github/basic-writing-and-formatting-syntax'
https://help.github.com/en/articles/setting-your-commit-email-address: link has moved permanently to 'https://help.github.com/en/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address'
https://help.shopify.com/en/themes/liquid/basics: link has moved permanently to 'https://shopify.dev/docs/liquid/reference/basics'
https://my.bluehost.com/cgi/help/559: link has moved permanently to 'https://www.bluehost.com/help/article/dns-management-add-edit-or-delete-dns-entries'
https://plot.ly/: link has moved permanently to 'https://plotly.com/'
https://poetry.eustace.io/: link has moved permanently to 'http://python-poetry.org/'
https://prometheus.io/docs/prometheus/latest/querying/basics: link has moved permanently to 'https://prometheus.io/docs/prometheus/latest/querying/basics/'
https://puppet.com/resources/whitepaper/2016-state-of-devops-report: link has moved permanently to 'https://puppet.com/resources/report/2016-state-devops-report/'
https://selenium.dev/: link has moved permanently to 'https://www.selenium.dev/'
https://vaultproject.io/: link has moved permanently to 'https://www.vaultproject.io/'
https://www.elastic.co/products/elastic-stack: link has moved permanently to 'https://www.elastic.co/elastic-stack'
https://www.elastic.co/products/elasticsearch/service: link has moved permanently to 'https://www.elastic.co/elasticsearch/service'
https://www.elastic.co/products/elasticsearch: link has moved permanently to 'https://www.elastic.co/elasticsearch'
https://www.salesforce.com/: link has moved permanently to 'https://www.salesforce.com/eu/?ir=1'
https://www.yubico.com/products/yubikey-hardware/: link has moved permanently to 'https://www.yubico.com/products/'
https://www2.le.ac.uk/offices/ld/resources/writing/grammar/grammar-guides/sentence: link has moved permanently to 'https://www2.le.ac.uk/offices/ld/all-resources/writing/grammar/grammar-guides/sentence'
https://yarnpkg.com/en/: link has moved permanently to 'https://classic.yarnpkg.com/en/'
https://yarnpkg.com/en/docs/install: link has moved permanently to 'https://classic.yarnpkg.com/en/docs/install'

Other

http://tatiyants.com/postgres-query-plan-visualization/: 406
http://tetraph.com/covert_redirect/: 502
http://try.commonmark.org: Failed to open TCP connection to try.commonmark.org:80 (Connection refused - connect(2) for "try.commonmark.org" port 80)
https://developers.facebook.com/: SSL_read: unexpected eof while reading
https://slack.com/help/articles/202035138: too many redirects
https://ultraauth.com: 525
Edited by Ray Paik