Visitar URL original
[FEATURE]: Docs automation has been dead since the org transfer, and 2.x releases publish no release notes · Issue #60273 · anomalyco/opencode · GitHub
Skip to content

[FEATURE]: Docs automation has been dead since the org transfer, and 2.x releases publish no release notes #60273

Closed as duplicate

Description

@lhpaoletti

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

The problem

Since 2.0, OpenCode ships features faster than its docs and release notes describe them, so after an update I cannot find out what is new or how to use it. The only way to discover post-2.0 behaviour is to read PRs, source, and git log.

I'm scoping this to the two concrete, cheap items underneath that. The rest of the symptoms are already tracked elsewhere.

Ask 1 — re-enable the docs automation (fixes #57623)

docs-update.yml gates its job on if: github.repository == 'sst/opencode'. The repo moved to anomalyco/opencode, so the condition can never be true: the last successful run was 2026-01-02, and ~582 runs since then are conclusion: skipped. docs-locale-sync.yml is if: false, and the v2 tree has no locale directories at all while v1 has 17.

This was reported in #57623 and confirmed by the triage bot on latest dev. As of today it is still open and unfixed. This is the highest-leverage item here: it is a one-line if: change plus a decision about which docs tree the workflow owns (#57623 notes both workflows write packages/web/src/content/docs/, the v1 tree that serves /docs, while the v2 tree is services/www/src/docs/content/).

Ask 2 — publish release notes for every 2.x release

There is no changelog a user can read for 2.x:

So the in-app surfaces for release notes already exist and are wired to data that is simply never populated. Publishing a short highlights list per release into changelog.json and GitHub Releases would light up the popup and /highlights for free, without new UI work.

For context on pace: since 2026-09-01 the repo has ~3296 commits (commits API, per_page=1, read from the Link header), against 103 commits touching packages/web/src/content/docs and 236 touching services/www/src/docs/content — about 1 in 7. Meanwhile v2.2.0 and v2.2.1 shipped on 2026-10-27 and 2026-10-29.

Why these two and not "write more docs"

Features that exist today but have no documented path to adoption — OTEL support (#47195), opencode mcp add --url/--header from #31054 (#55285), V2 keyless websearch (#54311), V2 service API auth (#51724), subagent_depth defaulting to 1 so subagents silently cannot delegate (#59826) — are a docs-velocity problem, not a docs-effort problem. Fixing the automation that has been dead since January, and telling users what each release changed, addresses the cause rather than the ~25 individual symptoms filed since.

Activity

  1. opencodejr commented on Oct 29, 2026

    @opencodejr

    Thanks for pulling all of this together, @lhpaoletti. I think this is a duplicate: each of the two asks is already tracked in its own open issue, and both of those have been reproduced. Ask 1 is #57623 and ask 2 is #60134.

    Possible duplicates and related issues, ordered by likelihood:

    The bot will close this issue as a duplicate in 1 day unless you reply explaining how it differs from these. If you have more details, adding them to #57623 or #60134 is the best way to make sure they're seen.

  2. lhpaoletti commented on Oct 29, 2026

    @lhpaoletti
    Author

    Oh, my bad 😅 You're right, both of those already exist. Checked and you're correct on both counts — the workflow is gone, and the notes are published, I just never found the feed. Close this as a dup, no hard feelings. I left the state-of-the-workflows update over on #57623 since its suggested fix is now impossible to apply.

  3. opencodejr commented on Oct 30, 2026

    @opencodejr

    We haven't heard back in the last day, so I'm closing this as a duplicate. Both of your asks are already tracked in open, reproduced issues:

    Please follow those issues for updates, or add any new details there. If this issue covers something they don't, reply here and it can be reopened. Thanks again for the thorough write-up, @lhpaoletti.

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

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions