Repository navigation
v2 Docs vs v1 Docs: v2's are outdated, miss information and nav is way worse #50683
Description
Description
From opencode.ai's homepage > Docs, it now opens the v2 Docs. https://opencode.ai/v2/docs
These are way behind on v1 Docs though.
Information is completely missing, is outdated, and navigation makes things way harder to find compared to the v1 docs.
The v1 docs are still maintained as well, but you have to manually enter its url to get there. https://opencode.ai/docs/
Take for example the Go information.
In v1 docs, in the menu you immediately see Usage > Go. Easy to find. Once there, you see Muse amongst the models. And Where can i use it, including Validated Clients. Last maintained Sept 21. https://opencode.ai/docs/go/
In v2 docs, in the menu there's no mention of Go nor is there a category like Usage. No, you first have to somehow know or guess that you need to open Providers.https://opencode.ai/v2/docs/providers/
There you see Go mentioned. Then you have to click Go Documentation from there. To finally land in the Go docs which are categorized under Console? https://opencode.ai/v2/docs/console/go
But Muse models aren't in the models table. There are less headers and there is less information. There is no Where can i use it, no Validated Clients.
Are the v2 Docs simply the v1 Docs from May or June or so? Badly kept up-to-date? And now somehow supposed to be used as the most current Docs? While the actual v1 Docs are still maintained and way more up-to-date and way easier to navigate? How has this even been decided?
Plugins
n/a
OpenCode version
n/a
Steps to reproduce
n/a
Screenshot and/or share link
n/a
Operating System
n/a
Terminal
n/a
Activity
github-actions commentedon Sep 22, 2026
This issue might be a duplicate of existing issues. Please check:
Please review those issues and their discussion before continuing here. If those issues were closed prematurely or didn't resolve your concern, please reference them in this issue and explain what's different or still unresolved.
opencodejr commentedon Oct 28, 2026
Thanks for the detailed feedback on the v2 docs, @VariableVince. You're asking that the v2 docs (now the default from the homepage) catch up with the v1 docs in content, and that topics like Go be as easy to find as under v1's Usage > Go.
Some notes from the current docs source:
services/www/src/docs/content/console/go.mdx) now includes the Muse Spark models, a Where can I use it? section and Validated clients. Some of what you saw may have been an older version of the page. If https://opencode.ai/v2/docs/console/go still doesn't show them for you, please say so here.I've passed this on as a docs improvement for maintainers to consider. If you notice other pages where v2 is missing information that v1 has, listing them here would help.