[docs] Explain why we make each BC

mui · Jun 22, 2020 · a15528e · a15528e
1 parent 7eb9aef
commit a15528e
Showing 1 changed file with 12 additions and 12 deletions.
diff --git a/docs/src/pages/guides/migration-v4/migration-v4.md b/docs/src/pages/guides/migration-v4/migration-v4.md
@@ -58,20 +58,20 @@ yarn add @material-ui/core
 
 ### Rating
 
-- Rename `visuallyhidden` to `visuallyHidden`
-
-```diff
-<Rating
-  classes={{
--    visuallyhidden: 'custom-visually-hidden-classname',
-+    visuallyHidden: 'custom-visually-hidden-classname',
-  }}
-/>
-```
+- Rename `visuallyhidden` to `visuallyHidden` for consistency:
+
+  ```diff
+  <Rating
+    classes={{
+  -    visuallyhidden: 'custom-visually-hidden-classname',
+  +    visuallyHidden: 'custom-visually-hidden-classname',
+    }}
+  />
+  ```
 
 ### TablePagination
 
-- The customization of the table pagination's actions labels must be done with the `getItemAriaLabel` prop.
+- The customization of the table pagination's actions labels must be done with the `getItemAriaLabel` prop. This increases consistency with the `Pagination` component.
 
   ```diff
   <TablePagination
@@ -82,7 +82,7 @@ yarn add @material-ui/core
 
 ### Typography
 
-- Replace `srOnly` prop support with a style util:
+- Replace `srOnly` prop support with a style util to not duplicate with the capabilities of the system:
 
   ```diff
   -import Typography from '@material-ui/core/Typography';