Skip to content

Update stale documentation links to canonical URLs#248

Open
alewolf wants to merge 1 commit into
WordPress:trunkfrom
alewolf:claude/fix-stale-doc-links
Open

Update stale documentation links to canonical URLs#248
alewolf wants to merge 1 commit into
WordPress:trunkfrom
alewolf:claude/fix-stale-doc-links

Conversation

@alewolf

@alewolf alewolf commented Jun 4, 2026

Copy link
Copy Markdown

Summary

Several reference links in docs/REQUIREMENTS.md pointed at repos that have since been renamed or documentation domains that have migrated. None were hard 404s today — they all still resolve via redirects — but redirects for renamed GitHub repos can break if the old path is later reclaimed, and the migrated docs domains are the canonical homes now. This updates each to its current canonical URL.

Changes (docs/REQUIREMENTS.md)

Old New Reason
docs.anthropic.com/en/api/ platform.claude.com/docs/en/api/ Docs domain migration
docs.fal.ai/model-endpoints fal.ai/docs/model-endpoints Docs host consolidated
cloud.google.com/vertex-ai/docs/reference/rest docs.cloud.google.com/vertex-ai/docs/reference/rest Google docs domain change
platform.openai.com/docs/api-reference/ developers.openai.com/api/reference/overview Docs site moved
docs.x.ai/docs/api-reference docs.x.ai/developers/rest-api-reference/inference/chat Old docs path
github.com/firebase/genkit github.com/genkit-ai/genkit Repo renamed
github.com/google/A2A github.com/a2aproject/A2A Repo moved (now under the Linux Foundation)

All seven replacement URLs were verified to return HTTP 200.

Props

Props @vyskoczilova for the contribution.

🤖 Generated with Claude Code

Several reference links in docs/REQUIREMENTS.md pointed at moved repos or
migrated documentation domains and only resolved via redirects. Update them
to their current canonical targets:

- Anthropic API docs -> platform.claude.com
- fal API docs -> fal.ai/docs
- Google Vertex AI docs -> docs.cloud.google.com
- OpenAI API reference -> developers.openai.com
- X AI API reference -> docs.x.ai/developers path
- Firebase Genkit repo -> genkit-ai/genkit (renamed)
- A2A protocol repo -> a2aproject/A2A (renamed)

Co-authored-by: Karolína Vyskočilová <3611726+vyskoczilova@users.noreply.github.com>
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings June 4, 2026 09:36

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Updates external documentation links in docs/REQUIREMENTS.md to reflect current vendor endpoints and repository locations.

Changes:

  • Refreshes API documentation URLs (Anthropic, fal, Vertex AI, OpenAI, xAI).
  • Updates GitHub repository links for Firebase Genkit and the A2A protocol.

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

@github-actions

github-actions Bot commented Jun 4, 2026

Copy link
Copy Markdown

The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. You can also manually ask me to refresh this list by adding the props-bot label.

If you're merging code through a pull request on GitHub, copy and paste the following into the bottom of the merge commit message.

Co-authored-by: alewolf <alekv@git.wordpress.org>

To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook.

@felixarntz felixarntz 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.

@alewolf Thank you for the PR!

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