Description
docs/src/content/docs/setup/quick-start.mdx gives the API-key setup path for every engine as 2 inline numbered steps plus a "more detail" link, but gives the WIF (Workload Identity Federation) alternative for Claude and Gemini as a single bare link with zero inline steps ("To avoid a long-lived key, configure Anthropic Workload Identity Federation" at line ~151, same pattern for Google WIF at ~171). The detailed steps do already exist at reference/auth.mdx ("### Anthropic Workload Identity Federation (WIF)", line 226) — so this isn't a missing-content gap, just an inline/asymmetric-presentation one. Confirmed live at HEAD. Flagged again today by Claude Code User Documentation Review #65329 (Major Obstacle #3).
Expected Impact
Removes the asymmetry that makes the keyless WIF path look like an afterthought compared to the API-key path, for users scanning quick-start.mdx who want to avoid long-lived secrets.
Suggested Agent
Documentation Noob Tester / Claude Code User Documentation Review follow-up, or a direct manual doc edit.
Estimated Effort
Quick (< 30 min) — add a 1-2 sentence inline summary (e.g., "federation rule + OIDC token, no repo secret") next to the WIF link in both the Claude and Gemini sections, mirroring the brevity of the API-key numbered steps.
Data Source
DeepReport Intelligence analysis, 2026-10-03, sourced from Claude Code User Documentation Review #65329 (Major Obstacle #3), live-verified against docs/src/content/docs/setup/quick-start.mdx:151,171 and docs/src/content/docs/reference/auth.mdx:226.
Generated by 🔬 Deep Report · claude · agent · 328.5 AIC · ⌖ 8.76 AIC · ⊞ 7.1K · ◷
Description
docs/src/content/docs/setup/quick-start.mdxgives the API-key setup path for every engine as 2 inline numbered steps plus a "more detail" link, but gives the WIF (Workload Identity Federation) alternative for Claude and Gemini as a single bare link with zero inline steps ("To avoid a long-lived key, configure Anthropic Workload Identity Federation" at line ~151, same pattern for Google WIF at ~171). The detailed steps do already exist atreference/auth.mdx("### Anthropic Workload Identity Federation (WIF)", line 226) — so this isn't a missing-content gap, just an inline/asymmetric-presentation one. Confirmed live at HEAD. Flagged again today by Claude Code User Documentation Review #65329 (Major Obstacle #3).Expected Impact
Removes the asymmetry that makes the keyless WIF path look like an afterthought compared to the API-key path, for users scanning quick-start.mdx who want to avoid long-lived secrets.
Suggested Agent
Documentation Noob Tester / Claude Code User Documentation Review follow-up, or a direct manual doc edit.
Estimated Effort
Quick (< 30 min) — add a 1-2 sentence inline summary (e.g., "federation rule + OIDC token, no repo secret") next to the WIF link in both the Claude and Gemini sections, mirroring the brevity of the API-key numbered steps.
Data Source
DeepReport Intelligence analysis, 2026-10-03, sourced from Claude Code User Documentation Review #65329 (Major Obstacle #3), live-verified against
docs/src/content/docs/setup/quick-start.mdx:151,171anddocs/src/content/docs/reference/auth.mdx:226.