diff --git a/readme.md b/readme.md
index 10570ed..0cc5fdc 100644
--- a/readme.md
+++ b/readme.md
@@ -1,18 +1,31 @@
-# Swiftly Swift - Github Action
+# Swiftly Swift - GitHub Action
 
-A Github Action to install [Swiftly](https://www.swift.org/swiftly/documentation/swiftlydocs/) and a swift toolchain. Works with MacOS and Linux runners.
+A GitHub Action to install [Swiftly](https://www.swift.org/swiftly/documentation/swiftlydocs/) and a swift 
+toolchain. Works with MacOS and Linux runners.
 
 ```yaml
-  - uses: beeauvin/swiftly-swift@v1
+  - uses: beeauvin/swiftly-swift@v2
     with:
-      swift-version: 6.1
+      swift-version: 6.2
+      # Optionally, disable caching swiftly
+      # swiftly-cache: 'false'
 ```
 
-`swift-version` is the Swift Toolchain version that Swiftly will install and defaults to `latest`. Any version string supported by Swiftly (including snapshots) should work.
+`swift-version` is the Swift Toolchain version that Swiftly will install and defaults to `latest`. Any
+version string supported by Swiftly (including snapshots) should work.
+
+### Caching
+
+By default `swiftly-swift` will cache both swiftly itself and the swift toolchain it resolves. Because there
+is not a reliable way to track and download specific swiftly versions we default to caching whatever is
+pulled and using `self-update` on each run to try and keep it at latest. If caching breaks or some other
+tragedy occurs you can delete your action cache or disable caching by setting `swiftly-cache` to `false`.
 
 ### Windows
 
-Unfortunately [Swiftly doesn't currently support windows](https://github.com/swiftlang/swiftly/issues/151) so this action doesn't either. Open to contributions to get it working with currently available install methods until Swiftly has support for it.
+Unfortunately [Swiftly doesn't currently support windows](https://github.com/swiftlang/swiftly/issues/151) so
+this action doesn't either. Open to contributions to get it working with currently available install methods
+until Swiftly has support for it.
 
 ## License