Review

docs/src/pages/components/buttons/buttons.md

@@ -139,8 +139,8 @@ Here is an [integration example with react-router](/guides/composition/#button).
 
 ### Cursor not-allowed
 
-Material-UI's ButtonBase component set `pointer-events: none;` on disabled buttons.
-This tradeoff prevents the usage of a different disabled cursor.
+The ButtonBase component sets `pointer-events: none;` on disabled buttons.
+which prevents the appearance of a disabled cursor.
 
 If you wish to use `not-allowed`, you have two options:
 
@@ -153,7 +153,10 @@ If you wish to use `not-allowed`, you have two options:
 }
 ```
 
-However, you should add `pointer-events: none;` back when you need to display [tooltips on disabled elements](/components/tooltips/#disabled-elements) and the cursor won't change if you render something else than a button element, for instance, a link `<a>` element.
+However:
+
+- You should add `pointer-events: none;` back when you need to display [tooltips on disabled elements](/components/tooltips/#disabled-elements)
+- The cursor won't change if you render something other than a button element, for instance, a link `<a>` element.
 
 2. **DOM change**. You can wrap the button:
 

docs/src/pages/components/tooltips/tooltips.md

@@ -73,7 +73,7 @@ A tooltip can be interactive. It won't close when the user hovers over the toolt
 
 ## Disabled Elements
 
-By default disabled elements like `<button>` do not trigger user interactions so a `Tooltip` will not activate on normal events like hover. To accommodate disabled elements, add a simple wrapper element like a `span`.
+By default disabled elements like `<button>` do not trigger user interactions so a `Tooltip` will not activate on normal events like hover. To accommodate disabled elements, add a simple wrapper element, such as a `span`.
 
 {{"demo": "pages/components/tooltips/DisabledTooltips.js"}}
 

packages/material-ui/src/Tooltip/Tooltip.js

@@ -134,7 +134,7 @@ const Tooltip = React.forwardRef(function Tooltip(props, ref) {
             'A disabled element does not fire events.',
             "Tooltip needs to listen to the child element's events to display the title.",
             '',
-            'Add a simple wrapper element like a `span`.',
+            'Add a simple wrapper element, such as a `span`.',
           ].join('\n'),
         );
       }