Skip to content

fix(console): point marketing docs links to the v2 docs - #56530

Draft
kitlangton wants to merge 1 commit into
devfrom
v2-docs-links
Draft

kitlangton wants to merge 1 commit into
devfrom
v2-docs-links

Conversation

@kitlangton

Copy link
Copy Markdown
Contributor

Why

The header sends people to the v2 docs, but the homepage "Read docs" button, the footer, the FAQ answers, the 404 page and the changelog footer still link to the v1 docs at /docs, which tell you to install v1. The /download FAQ had also drifted from the homepage FAQ: it says you "probably" need a paid AI subscription and doesn't mention the free models.

What Changes

Where Before After
Homepage "Read docs", footer "Docs", 404 "Docs", changelog footer /docs (localized v1) /v2/docs
FAQ "intro" link /docs /v2/docs
FAQ "local models" /docs/providers/#lm-studio /v2/docs/providers/#runtimes
FAQ "existing subscriptions" /docs/providers/#directory /v2/docs/providers/
FAQ "web" /docs/web, /docs/cli/#web /v2/docs/cli/web/
/download FAQ "Do I need extra AI subscriptions?" and "How much does it cost?" separate download.faq.* copy same answers as the homepage (home.faq.a3, home.faq.a6)

The unused download.faq.* strings are removed from all 18 locales.

Scope

The v2 docs are English-only for now, so localized visitors now get English v2 docs instead of localized v1 docs (#55448 adds translations). Links with no v2 page yet stay on v1: the homepage privacy link (/docs/enterprise/) and the IDE, GitHub and GitLab cards on /download.

Verification

cd packages/console/app && bun run typecheck && bun test
for p in /v2/docs /v2/docs/providers/ /v2/docs/cli/web/; do curl -s -o /dev/null -w "$p %{http_code}\n" https://opencode.ai$p; done

Typecheck passes, 50 tests pass, every new link target returns 200 on opencode.ai, and #runtimes exists on the providers page.

@opencode-agent opencode-agent Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

This looks good to me. Every link it touches now points to the v2 docs, the same way the header and the zen/go pages already do. The /download FAQ now reuses the homepage answers, and none of the removed download.faq.* keys are still referenced anywhere.

How I checked: typecheck and bun test pass in packages/console/app (50 tests) and in services/changelog (19 tests). /v2/docs, /v2/docs/providers/ and /v2/docs/cli/web/ all return 200 on opencode.ai, and the #runtimes section exists on the providers page.

Public API: no change. Only marketing site links, copy and i18n strings are affected.

No concerns.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant