From ae15bb72740000bd1ac563cf4a0f96d2e9c73d1f Mon Sep 17 00:00:00 2001
From: Alice Wyan <121136+wyan@users.noreply.github.com>
Date: Mon, 9 Jun 2025 15:03:41 +0200
Subject: [PATCH] Add browser cache explanation in samples.mdx

Several users (including me) have been bitten by this, so it's perhaps worth mentioning in the docs that the strudel.json file gets cached by the browser and doesn't reload properly unless forced.
---
 website/src/pages/learn/samples.mdx | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/website/src/pages/learn/samples.mdx b/website/src/pages/learn/samples.mdx
index 890de3aa..88a0a3b2 100644
--- a/website/src/pages/learn/samples.mdx
+++ b/website/src/pages/learn/samples.mdx
@@ -163,6 +163,12 @@ The last section could be written as:
 }
 ```
 
+Please note that browsers will often cache `strudel.json` on first load, and keep using the cached
+version even if the orginal has been updated. If this bites you (for example while developing a new
+sample pack), you can force the browser to download a new copy by i.e. changing capitalization of one
+character in the URL, or by removing it from cache (deleting cache in browser Privacy settings, or from
+the dev console if you're technically minded, or by using a cache deleting extension).
+
 ## Github Shortcut
 
 Because loading samples from github is common, there is a shortcut: