From d5ab6c50cb9a03ba4c3ed3edd81d224d35268b34 Mon Sep 17 00:00:00 2001
From: Nick Sweeting <git@sweeting.me>
Date: Sat, 1 Aug 2026 00:07:23 -0700
Subject: [PATCH] Clarify native package upgrade choice

---
 docs/Upgrading.md | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/docs/Upgrading.md b/docs/Upgrading.md
index 725804ee..63a6544b 100644
--- a/docs/Upgrading.md
+++ b/docs/Upgrading.md
@@ -1,9 +1,12 @@
 # Upgrading Versions
 
 ```bash
-# Native uv, apt, or brew install
-cd ~/archivebox/data
+# Update ArchiveBox using the package manager you originally installed it with
 uv tool install --python 3.13 --upgrade 'git+https://github.com/ArchiveBox/ArchiveBox.git@dev'
+# or: sudo apt update && sudo apt install --only-upgrade archivebox
+# or: brew update && brew upgrade archivebox
+
+cd ~/archivebox/data
 archivebox init
 archivebox install
 archivebox update