diff --git a/.changeset/tidy-steaks-arrive.md b/.changeset/tidy-steaks-arrive.md
index a504afa..eb39fae 100644
--- a/.changeset/tidy-steaks-arrive.md
+++ b/.changeset/tidy-steaks-arrive.md
@@ -3,4 +3,8 @@
 'eslint-plugin-widen': major
 ---
 
-Update to eslint 9. Apps will need to be on eslint 9+ alongside this update.
+Update to eslint 9, Apps will need to be on eslint 9+ alongside this update.
+They will also need to convert their .eslintrc and .eslint ignore into the new
+format of eslint.config.mjs. Here is a migration guide that goes over the basics
+https://eslint.org/docs/latest/use/configure/migration-guide. For general usage
+and a sample eslint.config.mjs see the updated readme in this repo.