Document shorthand-property-no-redundant-values extended description (#…

…6405)
stylelint · Oct 13, 2022 · c6b03ba · c6b03ba
1 parent 1fd5a15
commit c6b03ba
Showing 1 changed file with 5 additions and 1 deletion.
diff --git a/lib/rules/shorthand-property-no-redundant-values/README.md b/lib/rules/shorthand-property-no-redundant-values/README.md
@@ -9,7 +9,11 @@ a { margin: 1px 1px 1px 1px; }
  *           These values */
 ```
 
-This rule alerts you when you use redundant values in the following shorthand properties:
+You can use [shorthand properties](https://developer.mozilla.org/en-US/docs/Web/CSS/Shorthand_properties) to set multiple values at once. For example, you can use the `margin` property to set the `margin-top`, `margin-right`, `margin-bottom`, and `margin-left` properties at once.
+
+For some shorthand properties, e.g. those related to the [edges of a box](https://developer.mozilla.org/en-US/docs/Web/CSS/Shorthand_properties#edges_of_a_box), you can safely omitted some values.
+
+This rule checks the following shorthand properties:
 
 - `margin`
 - `padding`