Skip to content

docs: point download links to coder.com/downloads - #31205

Merged
nickvigilante merged 3 commits into
mainfrom
docs/link-downloads-page
Nov 4, 2026
Merged

nickvigilante merged 3 commits into
mainfrom
docs/link-downloads-page

Conversation

@coder

@coder coder Bot commented Oct 23, 2026 •

Copy link
Copy Markdown
Contributor

We launched a dedicated downloads page at https://coder.com/downloads with the latest mainline and stable builds for every OS and architecture, Coder Desktop installers, Helm charts, and checksums. This points the docs' "go download Coder" links there instead of GitHub releases.

Updated to the downloads page

  • install/cli.md, user-guides/workspace-access/zed.md: alternate install methods and the Windows installer. Also fixes the Windows file types: the installer is .exe and the standalone binary ships as a .zip (not .msi/.exe). Drops "from GitHub" from the cli.md section heading (no in-repo links used that anchor).
  • get-started/index.md: alternate install methods.
  • install/operate/upgrade.md: Windows upgrade download.
  • install/operate/provisioners/index.md: "full Coder binary" link.
  • install/server/rpm.md: RPM download, with GitHub releases kept for older versions.
  • install/prepare/airgap.md: Helm chart download (downloads page plus GitHub releases).
  • user-guides/desktop/index.md: macOS and Windows Coder Desktop manual installs.
  • reference/releases.md: latest stable/mainline from the downloads page, specific versions from GitHub releases.

Left on GitHub on purpose

  • Version-specific tag links and the release table in reference/releases.md.
  • "Review the release notes" links, the update-check description, and the air-gapped docs bundle (coder_docs_<version>.tgz isn't on the downloads page).
  • VS Code extension .vsix links (not on the downloads page).
  • admin/users/index.md: that block is literal coder users create output, so it should change with cli/usercreate.go in a follow-up, not here.

External links in the docs already open in a new tab on coder.com/docs (DocsHTMLRenderer adds target="_blank" rel="noopener"), so plain Markdown links are enough. No CTA button in this PR.

Vale, markdownlint, and scripts/docshtmlcheck pass on the changed files. The only Vale warning is one that was already in get-started/index.md.

Created on behalf of @nickvigilante

CI notes

Note added by Coder Agents.

@coder
coder Bot requested a review from nickvigilante as a code owner October 23, 2026 17:02
@github-actions

github-actions Bot commented Oct 23, 2026 •

Copy link
Copy Markdown
Contributor

Docs preview

Check off each page once it's been reviewed. If a page changes in a later push, its checkbox clears automatically so it gets a fresh look. Pages not yet wired into the docs navigation aren't listed here.

@github-actions github-actions Bot added the community Pull Requests and issues created by the community. label Oct 23, 2026

@nickvigilante nickvigilante left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Resolved merge conflicts with main in install/cli.md, install/operate/provisioners/index.md, and user-guides/workspace-access/zed.md (c776cb0). Kept the downloads-page links, plus main's "and so on" wording and its removal of "please" in zed.md.

Verified that https://coder.com/downloads lists Helm charts, RPMs, Coder Desktop .pkg/.exe, and checksums, and that the release assets match the new Windows file types (windows_*_installer.exe installer, windows_*.zip binary). No in-repo or org-wide references to the old #download-the-latest-release-from-github anchor. markdownlint passes, and Vale shows no new alerts relative to main.

Generated by Coder Agents on behalf of @nickvigilante.

@nickvigilante
nickvigilante enabled auto-merge (squash) October 26, 2026 17:39
nickvigilante added a commit that referenced this pull request Nov 2, 2026
…page (#31513)

The install landing page presented five phases that had to be read in
order, which doesn't fit every install.
This keeps the five-phase structure and adds the flexibility discussed
with Ben and Ian: put the options up front, offer shortcuts, and let
users skip what doesn't apply.

- Adds a **Choose your path** table that sends evaluators to the
Quickstart, users with a chosen platform to the control plane pages, and
everyone else through the phases in order.
- Adds a **Run Coder on a single server** section as the quick option.
It names what the Quickstart skips (sizing, DNS and TLS through the
tunnel, the identity provider, the license, and the external database),
explains what the built-in database means, and links to the migration
steps for when users outgrow it.
- Explains each of the five phases in more detail: what it does, who
needs it, what you finish with, and when you can skip it.
- Adds **Decisions worth making deliberately** for the choices that are
costly to change later.

The Slack discussion and the 1:1 described bundled versus external
PostgreSQL as irreversible.
The docs already describe a migration path
(`docs/admin/setup/index.md`), so the page calls it costly instead: it
needs downtime plus a dump and restore.
Topology, size, and network position come from the existing Plan page.

## Retire the CLI install page

[coder.com/downloads](https://coder.com/downloads) now covers what
`docs/install/cli.md` offered, so the page is gone:

- `/docs/install/cli` redirects to `https://coder.com/downloads`, and
the page is out of the sidebar.
- Inbound links point where the sentence means: the downloads page for
getting the binary, the CLI reference for usage (`sessions-tokens.md`,
`creating-templates.md`, `feature-stages.md`), and the Quickstart's
install step for running Coder with the install script
(`aws-marketplace.md`).
- The page's only content the downloads page lacks, installing the CLI
from your own deployment (air-gapped, version-matched), moves to a new
**Install the CLI** section in `user-guides/workspace-access/index.md`.
  The Zed and Claude Desktop guides link there.
- Winget and the Windows Visual C++ note already live in the Quickstart,
so they aren't moved.

This overlaps #31205, which edits `install/cli.md`, `zed.md`, and
`rpm.md`.
Whichever merges second needs a rebase, and #31205 should drop its
`cli.md` hunk.

A separate PR can add per-phase "skip if" notes to the phase pages, and
the install questionnaire stays a follow-up.

Checks: `make lint/emdash`, `lint/docs-html`, `lint/docs-manifest`,
`lint/docs-redirects`, markdownlint, and Vale.
Vale's remaining findings on changed files are on lines this PR doesn't
edit.

---

🤖 Generated with Coder Agents.
@nickvigilante
nickvigilante merged commit 9aa8b97 into main Nov 4, 2026
29 of 30 checks passed
@nickvigilante
nickvigilante deleted the docs/link-downloads-page branch November 4, 2026 21:22
@github-actions github-actions Bot locked and limited conversation to collaborators Nov 4, 2026
@nickvigilante

Copy link
Copy Markdown
Collaborator

Merged main into this branch to resolve the conflict. docs/install/cli.md was retired on main in #31513, so I accepted the deletion; main already links to coder.com/downloads from docs/install/index.md. CI is green, including lint, offlinedocs and check-docs. coder.com/downloads returns 200, and the remaining links in the diff resolve.

Generated by Coder Agents on behalf of @nickvigilante.

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

Labels

community Pull Requests and issues created by the community.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant