Skip to content

docs: repair CLI archive and MCP installer release recipes #1183

Closed
#1184
Closed
docs: repair CLI archive and MCP installer release recipes#1183
#1184

Description

@joshrotenberg
joshrotenberg
opened on Oct 6, 2026

Reproduced on 2026-10-06

The installation guides currently contain recipes that cannot install the published binaries:

  • docs/docs/getting-started/installation.md advertises redisctl-aarch64-unknown-linux-gnu.tar.xz; the URL returns HTTP 404. This target is not in the published redisctl-v0.12.1 release.
  • docs/docs/mcp/getting-started.md uses repository-wide releases/latest/download/redisctl-mcp-installer.sh and .ps1; both return HTTP 404. The latest release is redisctl-v0.12.1 (CLI only); MCP installers are in redisctl-mcp-v0.12.1.
  • The CLI archive recipes extract with tar xJ, then move redisctl from the current directory. The checksum-verified Apple ARM64 archive actually contains redisctl-aarch64-apple-darwin/redisctl, so the documented move fails.
  • The version example still says 0.11.1.

Bounded acceptance criteria

  • CLI and MCP examples select their own application's published release, not an ambiguous workspace-wide latest tag.
  • Archive extraction/install steps match the verified artifact layout.
  • Linux ARM64 documentation does not promise an unavailable native archive; source/Docker alternatives are explicit.
  • Version verification is consistent with the example release.
  • Validate all documented release asset URLs against the published release, run a disposable host-native archive/version smoke check, and build/lint the changed docs.

Documentation only: no release, publishing, supported-target changes, installer execution, onboarding/credential policy changes, or database default cutover. This is one bounded contribution to the release-artifact evidence work; leaves #1087 open.

Activity

  1. joshrotenberg
    added a commit that references this issue on Oct 6, 2026

    docs: repair application-specific release installation recipes (#1183)

    fc69f83

  2. joshrotenberg commented on Oct 6, 2026

    @joshrotenberg
    joshrotenberg
    on Oct 6, 2026
    CollaboratorAuthor

    Implemented in draft #1184 at 19376e6e70813a3a4e348b7151d7859026fe4748. All 8 release URLs return 200 and the published Apple ARM64 archive checksum/layout plus the corrected recipe's disposable install/version smoke check pass. Strict MkDocs, formatting and all-feature Clippy pass; whole-file Markdown lint has the same 20 pre-existing diagnostics (none added, none suppressed). Current-head CI is pending; PR stays draft. No release/runtime/credential/default changes. Leaves #1087 open.

  3. joshrotenberg commented on Oct 6, 2026

    @joshrotenberg
    joshrotenberg
    on Oct 6, 2026
    CollaboratorAuthor

    PR #1184 is now ready at 19376e6e70813a3a4e348b7151d7859026fe4748: independent agent review found no actionable findings, and exact-head CI finished with 15 passing checks / 7 expected skips. Verified underlying test/build/docs steps, not just aggregate status. Prior artifact smoke/URL evidence remains valid; 20 unchanged local Markdown-lint baseline diagnostics remain disclosed. Required human review and Josh's merge decision remain; no merge or release. Leaves #1087 open.

  4. joshrotenberg
    added a commit that references this issue on Oct 9, 2026

    docs: repair application-specific release installation recipes (#1184)

    6a5ec44
  5. joshrotenberg
    closed this as completedin #1184on Oct 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions