CI test failures on main: `@azure/openai` (broken documentation links)

[github-actions]

Summary

1 package affected (@azure/openai), 2 CI check runs failing (js - openai and js - openai (Build Analyze)), detected on commit 50d07d73 (2026-06-04). The Build Analyze step fails because the link checker finds three 404 broken links in the package README. No unit-test failures were detected; the only CI regressions are these broken external documentation links.

Failures

@azure/openai

Failing check runs:

• js - openai (check run 79496802009)
• js - openai (Build Analyze) (check run 79496110684)

Error:

[404] broken link (platform.openai.com/redacted)
[404] broken link (platform.openai.com/redacted)
[404] broken link (platform.openai.com/redacted)
PowerShell exited with code '1'.

Root cause:
OpenAI has reorganised/renamed their documentation pages. Three links in sdk/openai/openai/README.md (lines 77, 92, 100) now return HTTP 404, causing the CI link-checker to fail the Build Analyze job.

Suggested fix:
Update the three broken URLs to their current equivalents on the OpenAI platform docs. The new canonical paths as of mid-2026 are typically:

• Speech-to-text: `(platform.openai.com/redacted)
• Image generation: `(platform.openai.com/redacted)
• Embeddings: `(platform.openai.com/redacted)

--- a/sdk/openai/openai/README.md
+++ b/sdk/openai/openai/README.md
@@ -74,7 +74,7 @@
 ### Audio transcription/translation and text-to-speech generation
 
-See [OpenAI Capabilities: Speech to text]((platform.openai.com/redacted)
+See [OpenAI Capabilities: Speech to text]((platform.openai.com/redacted)
 
 ### Batch
@@ -89,7 +89,7 @@
 ### Image generation
 
-See [OpenAI Capabilities: Image generation]((platform.openai.com/redacted)
+See [OpenAI Capabilities: Image generation]((platform.openai.com/redacted)
 
 ### Files
@@ -97,7 +97,7 @@
 ### Text embeddings
 
-See [OpenAI Capabilities: Embeddings]((platform.openai.com/redacted)
+See [OpenAI Capabilities: Embeddings]((platform.openai.com/redacted)

Note: The exact replacement URLs should be verified by a maintainer before merging — OpenAI may have further reorganised their docs. If the target pages have different paths, update accordingly.

Reproduced locally: N/A — this is a documentation link-check failure in the CI Build Analyze step, not a runtime or unit-test failure.

---

Additional Notes

• No known pre-existing failures were found in the tracking issue #37864 that match this failure.
• The three 404 links are all in the same file (sdk/openai/openai/README.md) and can be fixed in a single commit.
• No unit test failures were detected across the 5 most-recent commits on main; this CI failure is purely from the external link checker.

Generated by Analyze CI Test Failures · ● 3.9M · ◷