Merge pull request #2124 from Shopify/update-migration-docs

[Docs] Update migration docs
Shopify · Sep 12, 2019 · 440c6bd · 440c6bd
2 parents e3be184 + c0bfdda
commit 440c6bd
Show file tree

Hide file tree

Showing 2 changed files with 3 additions and 1 deletion.
diff --git a/UNRELEASED.md b/UNRELEASED.md
@@ -20,6 +20,8 @@ Use [the changelog guidelines](https://git.io/polaris-changelog-guidelines) to f
 
 ### Documentation
 
+- Updated the `withContext` section in the [v3 to v4 migration guide](https://github.com/Shopify/polaris-react/blob/master/documentation/guides/migrating-from-v3-to-v4.md) ([#2124](https://github.com/Shopify/polaris-react/pull/2124))
+
 ### Development workflow
 
 ### Dependency upgrades

diff --git a/documentation/guides/migrating-from-v3-to-v4.md b/documentation/guides/migrating-from-v3-to-v4.md
@@ -237,7 +237,7 @@ The `Tabs.Panel` subcomponent has been removed. This was an undocumented subcomp
 
 ### WithContext <a name="polaris-withcontext"></a>
 
-The `WithContext` component has been removed. It was used as a utility to handle multiple [legacy contexts](https://reactjs.org/docs/legacy-context.html) at once. Use [modern contexts](https://reactjs.org/docs/context.html#api) and access them using providers, hooks or `Class.contextType` instead.
+The `WithContext` component has been removed. It was used as a utility to handle [legacy contexts](https://reactjs.org/docs/legacy-context.html) in class based components and multiple contexts at once. Use [modern contexts](https://reactjs.org/docs/context.html#api) and access them using providers, hooks, or `Class.contextType` instead.
 
 ```jsx
 // old
-Original file line number
+Diff line change
@@ Expand Up @@
     ### WithContext <a name="polaris-withcontext"></a>
-    The `WithContext` component has been removed. It was used as a utility to handle multiple [legacy contexts](https://reactjs.org/docs/legacy-context.html) at once. Use [modern contexts](https://reactjs.org/docs/context.html#api) and access them using providers, hooks or `Class.contextType` instead.
+    The `WithContext` component has been removed. It was used as a utility to handle [legacy contexts](https://reactjs.org/docs/legacy-context.html) in class based components and multiple contexts at once. Use [modern contexts](https://reactjs.org/docs/context.html#api) and access them using providers, hooks, or `Class.contextType` instead.
     ```jsx
     // old
@@ Expand Down @@