Skip to content

docs: clarify Homebrew update vs upgrade for canton-devkit - #343

Merged
zheli merged 2 commits into
mainfrom
zzz/7fa98da9
Sep 21, 2026
Merged

zheli merged 2 commits into
mainfrom
zzz/7fa98da9

Conversation

@zheli

@zheli zheli commented Sep 21, 2026

Copy link
Copy Markdown
Contributor

Summary

Clarify how to upgrade canton-devkit via Homebrew so operators do not confuse brew update with brew upgrade, and document the recommended brew update && brew upgrade canton-devkit flow.

Changes

  • Expand the Upgrade section in docs/homebrew.md (update vs upgrade, wrong brew update canton-devkit usage, one-liner, already-installed case, version checks)
  • Align the short upgrade snippet in docs/getting-started.md
  • Update the Homebrew page description in website/docs-map.mjs

Test plan

  • Docs-only change (no make test / make lint required)
  • Skim rendered Homebrew + Getting Started upgrade sections after site sync
  • Confirm brew update && brew upgrade canton-devkit matches local Homebrew behavior

Checklist

  • Tests pass locally (N/A — docs only)
  • No coverage regression on touched code (N/A)
  • Docs updated (and website/ synced if any mirrored docs/*.md changed)
  • CLI ↔ Web UI parity maintained (or follow-up issue + TODO(#issue) comment) (N/A)

Operators often pass a formula name to brew update and miss new releases; document the correct refresh-then-upgrade flow.
Tighten the upgrade wording and normalize nearby markdown table formatting so the install guide stays consistent.
@zheli
zheli marked this pull request as ready for review September 21, 2026 13:12
@zheli
zheli merged commit b73a260 into main Sep 21, 2026
1 check passed
@zheli
zheli deleted the zzz/7fa98da9 branch September 21, 2026 13:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant