Skip to content

Fix docs link-validator failures from stale experiments page URLs#32490

Merged
pelikhan merged 1 commit into
mainfrom
copilot/fix-docs
May 15, 2026
Merged

Fix docs link-validator failures from stale experiments page URLs#32490
pelikhan merged 1 commit into
mainfrom
copilot/fix-docs

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented May 15, 2026

The docs deploy workflow failed in link validation because several pages still referenced removed experiments routes (/guides/... and /reference/...). This PR updates those references to the current /practices/... routes so the docs build can resolve all internal links.

  • Scope of fix

    • Updated stale experiments links in:
      • docs/src/content/docs/practices/experiments-specification.md
      • docs/src/content/docs/reference/artifacts.md
      • docs/src/content/docs/reference/forecast-specification.md
      • docs/src/content/docs/reference/glossary.md
  • Route corrections applied

    • /gh-aw/guides/experiments//gh-aw/practices/experiments/
    • /gh-aw/reference/experiments-specification//gh-aw/practices/experiments-specification/
  • Representative change

    - See [A/B Experiments](/gh-aw/guides/experiments/)
    + See [A/B Experiments](/gh-aw/practices/experiments/)

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
@pelikhan pelikhan marked this pull request as ready for review May 15, 2026 22:41
Copilot AI review requested due to automatic review settings May 15, 2026 22:41
@pelikhan pelikhan merged commit bc33330 into main May 15, 2026
2 checks passed
@pelikhan pelikhan deleted the copilot/fix-docs branch May 15, 2026 22:42
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Updates internal documentation links to reflect the current Experiments documentation routes, resolving link-validator failures in the docs deploy workflow caused by stale /guides/... and /reference/... URLs.

Changes:

  • Replaced stale /gh-aw/guides/experiments/ links with /gh-aw/practices/experiments/.
  • Replaced stale /gh-aw/reference/experiments-specification/ links with /gh-aw/practices/experiments-specification/.
  • Updated references consistently across glossary, artifacts reference, forecast specification, and the experiments specification page.
Show a summary per file
File Description
docs/src/content/docs/reference/glossary.md Updates glossary cross-links for A/B Experiments and the experiments specification to the /practices/ routes.
docs/src/content/docs/reference/forecast-specification.md Updates both “out of scope” and normative reference links to the experiments specification /practices/ route.
docs/src/content/docs/reference/artifacts.md Updates the A/B Experiments link in the experiment artifact section to the /practices/ route.
docs/src/content/docs/practices/experiments-specification.md Updates “Latest Version” link to the current /practices/experiments-specification/ route.

Copilot's findings

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

  • Files reviewed: 4/4 changed files
  • Comments generated: 0

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.

3 participants