Repository navigation
docs: point download links to coder.com/downloads - #31205
Conversation
Docs previewCheck 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. |
nickvigilante
left a comment
There was a problem hiding this comment.
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.
…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.
|
Merged main into this branch to resolve the conflict. Generated by Coder Agents on behalf of @nickvigilante. |
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.exeand the standalone binary ships as a.zip(not.msi/.exe). Drops "from GitHub" from thecli.mdsection 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
reference/releases.md.coder_docs_<version>.tgzisn't on the downloads page)..vsixlinks (not on the downloads page).admin/users/index.md: that block is literalcoder users createoutput, so it should change withcli/usercreate.goin a follow-up, not here.External links in the docs already open in a new tab on coder.com/docs (
DocsHTMLRendereraddstarget="_blank" rel="noopener"), so plain Markdown links are enough. No CTA button in this PR.Vale, markdownlint, and
scripts/docshtmlcheckpass on the changed files. The only Vale warning is one that was already inget-started/index.md.Created on behalf of @nickvigilante
CI notes
Storybookflaked once: the play function forpages-deploymentsettingspage-oauth2appssettingspageview--settings-value-omittedthrew. That code isn't touched by this PR, and the job passed on rerun.lintandofflinedocsfail on a stale generateddocs/reference/cli/ping.mdinherited frommain(feat: add JSON output to coder ping #30148). fix(docs/reference/cli): regenerate ping docs with table headers #31292 fixes it, and these checks will pass after it merges andmainis merged into this branch again.Note added by Coder Agents.