diff --git a/README.md b/README.md
index e5414d71..a5ae143d 100644
--- a/README.md
+++ b/README.md
@@ -592,6 +592,43 @@ See [inputs](#inputs) for more information.
 >     However, this action will handle spaces in file names, with a recommendation of using a separator to prevent hidden issues.
 >     ![Screen Shot 2021-10-23 at 9 37 34 AM](https://user-images.githubusercontent.com/17484350/138558767-b13c90bf-a1ae-4e86-9520-70a6a4624f41.png)
 
+## Migration guide
+
+With the switch from using grep's Extended regex to match files to the natively supported workflow glob pattern matching syntax introduced in [v13](https://github.com/tj-actions/changed-files/releases/tag/v13) you'll need to modify patterns used to match `files`.
+
+**BEFORE**
+
+```yml
+...
+
+      - name: Get specific changed files
+        id: changed-files-specific
+        uses: tj-actions/changed-files@v12.2
+        with:
+          files: |
+            \.sh$
+            .(sql|py)$
+            ^(mynewfile|custom)
+```
+
+**AFTER**
+
+```yml
+...
+
+      - name: Get specific changed files
+        id: changed-files-specific
+        uses: tj-actions/changed-files@v24
+        with:
+          files: |
+            *.sh
+            *.sql
+            *.py
+            mynewfile
+            custom/**
+```
+
+
 ## Credits
 
 This package was created with [Cookiecutter](https://github.com/cookiecutter/cookiecutter).