Merge 9efb3f33bc into 36f1e144e1

README.md

@@ -209,6 +209,9 @@ A cache key can include any of the contexts, functions, literals, and operators
 
 For example, using the [`hashFiles`](https://docs.github.com/en/actions/learn-github-actions/expressions#hashfiles) function allows you to create a new cache when dependencies change.
 
+> [!NOTE]  
+> The cache key is rendered during the restore stage, so can only depend on file state at that stage.
+
 ```yaml
   - uses: actions/cache@v4
     with: