From 2b7b22cddb293259e55c714039118cefbea9cc2d Mon Sep 17 00:00:00 2001
From: Alex Verkhovsky <alexey.verkhovsky@gmail.com>
Date: Thu, 20 Aug 2026 22:55:23 -0700
Subject: [PATCH] docs(release): note the raw.githubusercontent CDN delay after
 a release

---
 tools/release.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/tools/release.md b/tools/release.md
index a7e68797a..f4bbcbaf4 100644
--- a/tools/release.md
+++ b/tools/release.md
@@ -96,3 +96,9 @@ git fetch origin
 git show origin/main:skills/bmad/module-manifest.toml   # version = "<version>"
 git show origin/dev:skills/bmad/module-manifest.toml    # still the placeholder
 ```
+
+Note: installed copies check for updates through `raw.githubusercontent.com`,
+which caches files for around five minutes. Right after the push, update
+checks may still report the previous version; that is the CDN, not a failed
+release. Verify through git (above), or wait a few minutes before trusting
+an update check.