Skip to content

v2 Docs vs v1 Docs: v2's are outdated, miss information and nav is way worse #50625

Closed

Description

@VariableVince

Feature hasn't been suggested before.

  • I have verified this feature I'm about to request hasn't been suggested before.

Describe the enhancement you want to request

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 that the homepage redirects to? 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?

Activity

  1. github-actions commented on Sep 22, 2026

    @github-actions
    Contributor

    This issue doesn't fully meet our contributing guidelines.

    What needs to be fixed:

    • Feature requests must have a title starting with [FEATURE]:, but this issue's title does not follow that format.
    • The content describes a documentation quality/navigation concern, which is better suited to a Bug Report template (with steps to reproduce, context, etc.) rather than a Feature Request. Please use the appropriate template.
    • This appears to be a resubmission of v2 Docs vs v1 Docs: v2's are outdated, miss information and nav is way worse #50624, which was closed for compliance reasons. Resubmitting with a different template without addressing the original issues is not the right path forward.

    Please edit this issue (or open a new one with the correct template) to address the above within 2 hours, or it will be automatically closed.


    This issue might be a duplicate of existing issues. Please check:

    If you believe this was flagged incorrectly, please let a maintainer know.

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

Metadata

Metadata

Assignees

Labels

needs:complianceThis means the issue will auto-close after 2 hours.

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions