Merge 59284659c6 into 638ed79f9d

Add note on runner versions

README.md

@@ -19,16 +19,19 @@ See ["Caching dependencies to speed up workflows"](https://docs.github.com/en/ac
 
 The cache backend service has been rewritten from the ground up for improved performance and reliability. [actions/cache](https://github.com/actions/cache) now integrates with the new cache service (v2) APIs.
 
-The new service will gradually roll out as of **February 1st, 2025**. The legacy service will also be sunset on the same date. Changes in these release are **fully backward compatible**.
+The new service will gradually roll out as of **February 1st, 2025**. The legacy service will also be sunset on the same date. Changes in these releases are **fully backward compatible**.
 
 **We are deprecating some versions of this action**. We recommend upgrading to version `v4` or `v3` as soon as possible before **February 1st, 2025.** (Upgrade instructions below).
 
-If you are using pinned SHAs, please use the SHAs of versions `v4.2.0` or `v3.4.0`
+If you are using pinned SHAs, please use the SHAs of versions `v4.2.0` or `v3.4.0`.
 
 If you do not upgrade, all workflow runs using any of the deprecated [actions/cache](https://github.com/actions/cache) will fail.
 
 Upgrading to the recommended versions will not break your workflows.
 
+> **Additionally, if you are managing your own GitHub runners, you must update your runner version to `2.231.0` or newer to ensure compatibility with the new cache service.**  
+> Failure to update both the action version and your runner version may result in workflow failures after the migration date.
+
 Read more about the change & access the migration guide: [reference to the announcement](https://github.com/actions/cache/discussions/1510).
 
 ### v4

examples.md

@@ -6,16 +6,19 @@
 - [D - DUB](#d---dub)
   - [POSIX](#posix)
   - [Windows](#windows)
+- [Dart](#dart)
+  - [Linux / Macos](#linux--macos)
+  - [Windows](#windows-1)
 - [Deno](#deno)
   - [Linux](#linux)
   - [macOS](#macos)
-  - [Windows](#windows-1)
+  - [Windows](#windows-2)
 - [Elixir - Mix](#elixir---mix)
 - [Erlang - Rebar3](#erlang--rebar3)
 - [Go - Modules](#go---modules)
   - [Linux](#linux-1)
   - [macOS](#macos-1)
-  - [Windows](#windows-2)
+  - [Windows](#windows-3)
 - [Haskell - Cabal](#haskell---cabal)
 - [Haskell - Stack](#haskell---stack)
 - [Java - Gradle](#java---gradle)
@@ -140,6 +143,26 @@ steps:
     restore-keys: |
       ${{ runner.os }}-dub-
 ```
+## Dart
+
+### Linux / Macos
+```yaml
+- uses: actions/cache@v3
+  with:
+    path: |
+      ~/.pub-cache/
+    key: ${{ runner.os }}-dart-${{ hashFiles('**/pubspec.lock') }}
+```
+
+### Windows
+On windows the global package cache is located at `%LOCALAPPDATA%\Pub\Cache` but may vary due to different windows version. Refer to the [docs](https://dart.dev/tools/pub/cmd/pub-get#the-system-package-cache)
+```yaml
+- uses: actions/cache@v3
+  with:
+    path: |
+      ~/AppData/Local/Pub/Cache/
+    key: ${{ runner.os }}-dart-${{ hashFiles('**/pubspec.lock') }}
+```
 
 ## Deno