diff --git a/docs/repo-docs/crafting-your-repository/upgrading.mdx b/docs/repo-docs/crafting-your-repository/upgrading.mdx
index 98beed02b06aa..a4c43f9fc280f 100644
--- a/docs/repo-docs/crafting-your-repository/upgrading.mdx
+++ b/docs/repo-docs/crafting-your-repository/upgrading.mdx
@@ -95,6 +95,13 @@ Turborepo 2.0 requires that your Workspace define this field as a way to improve
 </Tab>
 </PackageManagerTabs>
 
+</Step>
+<Step>
+
+### Update `eslint-config-turbo`
+
+[`eslint-config-turbo`](/repo/docs/reference/eslint-config-turbo) helps identify environment variables that need to be added to the [`env`](/repo/docs/reference/configuration#env) key for caching. If you're using it, make sure you update it to match your major version.
+
 </Step>
 
 <Step>