From 08429cc16911d993c9e60cfa3daeee1d916e4304 Mon Sep 17 00:00:00 2001
From: Romain Menke
Date: Fri, 15 Dec 2023 20:17:53 +0100
Subject: [PATCH] Update warning and caution messages
---
.github/bin/generate-docs/cors-template.md | 9 +++++----
cli/csstools-cli/README.md | 5 +++--
experimental/css-has-pseudo/CHANGELOG.md | 3 ++-
experimental/css-has-pseudo/INSTALL-POSTCSS.md | 3 ++-
experimental/css-has-pseudo/README-POSTCSS.md | 3 ++-
experimental/css-has-pseudo/README.md | 3 ++-
experimental/postcss-nesting/README.md | 3 ++-
plugin-packs/postcss-preset-env/README.md | 5 ++---
plugins/css-has-pseudo/README.md | 14 ++++++++------
plugins/css-has-pseudo/docs/README.md | 5 +++--
plugins/css-prefers-color-scheme/README.md | 14 ++++++++------
plugins/css-prefers-color-scheme/docs/README.md | 5 +++--
plugins/postcss-color-function/README.md | 3 ++-
plugins/postcss-color-function/docs/README.md | 3 ++-
.../postcss-color-functional-notation/README.md | 3 ++-
plugins/postcss-custom-media/README.md | 5 +++--
plugins/postcss-custom-media/docs/README.md | 5 +++--
.../postcss-double-position-gradients/README.md | 3 ++-
.../README.md | 11 +++++++----
.../docs/README.md | 11 +++++++----
plugins/postcss-lab-function/README.md | 3 ++-
plugins/postcss-oklab-function/README.md | 3 ++-
.../README.md | 5 +++--
plugins/postcss-selector-not/README.md | 5 +++--
plugins/postcss-selector-not/docs/README.md | 5 +++--
25 files changed, 83 insertions(+), 54 deletions(-)
diff --git a/.github/bin/generate-docs/cors-template.md b/.github/bin/generate-docs/cors-template.md
index f69d28f62..7f7f2c665 100644
--- a/.github/bin/generate-docs/cors-template.md
+++ b/.github/bin/generate-docs/cors-template.md
@@ -1,9 +1,10 @@
## CORS
-⚠️ Applies to you if you load CSS from a different domain than the page.
-
-In this case the CSS is treated as untrusted and will not be made available to the JavaScript polyfill.
-The polyfill will not work without applying the correct configuration for CORS.
+> [!IMPORTANT]
+> Applies to you if you load CSS from a different domain than the page.
+>
+> In this case the CSS is treated as untrusted and will not be made available to the JavaScript polyfill.
+> The polyfill will not work without applying the correct configuration for CORS.
Example :
diff --git a/cli/csstools-cli/README.md b/cli/csstools-cli/README.md
index 3dfec812f..88955e825 100644
--- a/cli/csstools-cli/README.md
+++ b/cli/csstools-cli/README.md
@@ -10,10 +10,11 @@
## Usage
We recommend using the [CSSTools CLI] as a prototyping and debugging tool.
-⚠️ If you are building/customizing a toolchain it is best **not** to use the CLI.
-
With `npx` you can use the CLI directly without installing it globally.
+> [!CAUTION]
+> If you are building/customizing a toolchain it is best **not** to use the CLI.
+
### General Help :
```bash
diff --git a/experimental/css-has-pseudo/CHANGELOG.md b/experimental/css-has-pseudo/CHANGELOG.md
index 0e8e1026f..2b4facc2f 100644
--- a/experimental/css-has-pseudo/CHANGELOG.md
+++ b/experimental/css-has-pseudo/CHANGELOG.md
@@ -7,7 +7,8 @@ _July 8, 2022_
- `@csstools/css-has-pseudo-experimental` is no longer supported. Please use `css-has-pseudo` instead.
All issues have been resolved in the main plugin and the experimental plugin is no longer maintained.
-⚠️ This experimental plugin no longer has any effect on the output of your CSS.
+> [!CAUTION]
+> This experimental plugin no longer has any effect on the output of your CSS.
### 0.5.2
diff --git a/experimental/css-has-pseudo/INSTALL-POSTCSS.md b/experimental/css-has-pseudo/INSTALL-POSTCSS.md
index 59bf48943..6036b67f3 100644
--- a/experimental/css-has-pseudo/INSTALL-POSTCSS.md
+++ b/experimental/css-has-pseudo/INSTALL-POSTCSS.md
@@ -2,7 +2,8 @@
[EXPERIMENTAL CSS Has Pseudo] runs in all Node environments, with special instructions for:
-⚠️ Experimental version of [CSS Has Pseudo](https://github.com/csstools/postcss-plugins/tree/main/plugins/css-has-pseudo)
+> [!WARNING]
+> Experimental version of [CSS Has Pseudo](https://github.com/csstools/postcss-plugins/tree/main/plugins/css-has-pseudo)
| [Node](#node) | [PostCSS CLI](#postcss-cli) | [Webpack](#webpack) | [Gulp](#gulp) | [Grunt](#grunt) |
| --- | --- | --- | --- | --- |
diff --git a/experimental/css-has-pseudo/README-POSTCSS.md b/experimental/css-has-pseudo/README-POSTCSS.md
index 403c394bf..2d1af65b3 100644
--- a/experimental/css-has-pseudo/README-POSTCSS.md
+++ b/experimental/css-has-pseudo/README-POSTCSS.md
@@ -3,7 +3,8 @@
[![NPM Version][npm-img]][npm-url]
[
][discord]
-⚠️ Experimental version of [CSS Has Pseudo](https://github.com/csstools/postcss-plugins/tree/main/plugins/css-has-pseudo)
+> [!WARNING]
+> Experimental version of [CSS Has Pseudo](https://github.com/csstools/postcss-plugins/tree/main/plugins/css-has-pseudo)
[EXPERIMENTAL CSS Has Pseudo] lets you style elements relative to other elements in CSS,
following the [Selectors Level 4] specification.
diff --git a/experimental/css-has-pseudo/README.md b/experimental/css-has-pseudo/README.md
index d32523ec7..45f2129ed 100644
--- a/experimental/css-has-pseudo/README.md
+++ b/experimental/css-has-pseudo/README.md
@@ -6,7 +6,8 @@
`@csstools/css-has-pseudo-experimental` is no longer supported. Please use `css-has-pseudo` instead.
All issues have been resolved in the main plugin and the experimental plugin is no longer maintained.
-⚠️ This experimental plugin no longer has any effect on the output of your CSS.
+> [!CAUTION]
+> This experimental plugin no longer has any effect on the output of your CSS.
[discord]: https://discord.gg/bUadyRwkJS
[npm-img]: https://img.shields.io/npm/v/@csstools/css-has-pseudo-experimental.svg
diff --git a/experimental/postcss-nesting/README.md b/experimental/postcss-nesting/README.md
index ff26345f5..3bb713545 100644
--- a/experimental/postcss-nesting/README.md
+++ b/experimental/postcss-nesting/README.md
@@ -8,7 +8,8 @@
[CSS Nesting] specification. If you want nested rules the same way [Sass] works
you might want to use [PostCSS Nested] instead.
-⚠️ Experimental version of [PostCSS Nesting](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-nesting)
+> [!WARNING]
+> Experimental version of [PostCSS Nesting](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-nesting)
```pcss
a, b {
diff --git a/plugin-packs/postcss-preset-env/README.md b/plugin-packs/postcss-preset-env/README.md
index d0a0761da..bebb4dc12 100644
--- a/plugin-packs/postcss-preset-env/README.md
+++ b/plugin-packs/postcss-preset-env/README.md
@@ -134,9 +134,8 @@ features and supports **all** browsers.
[**Try it out in the Playground!**](https://preset-env.cssdb.org/playground/)
-⚠️ Please note that some features need a companion library that makes
-the feature work. While we try to avoid this requirement, there are instances
-in which this isn't possible to polyfill a new behaviour with _just_ CSS.
+> [!NOTE]
+> Please note that some features need a companion library that makes the feature work. While we try to avoid this requirement, there are instances in which this isn't possible to polyfill a new behaviour with _just_ CSS.
[See the list below](#plugins-that-need-client-library).
diff --git a/plugins/css-has-pseudo/README.md b/plugins/css-has-pseudo/README.md
index af13810e6..f3711cdcf 100644
--- a/plugins/css-has-pseudo/README.md
+++ b/plugins/css-has-pseudo/README.md
@@ -170,8 +170,9 @@ or
```
-⚠️ Please use a versioned url, like this : `https://unpkg.com/css-has-pseudo@6.0.0/dist/browser-global.js`
-Without the version, you might unexpectedly get a new major version of the library with breaking changes.
+> [!TIP]
+> Please use a versioned url, like this : `https://unpkg.com/css-has-pseudo@6.0.0/dist/browser-global.js`
+> Without the version, you might unexpectedly get a new major version of the library with breaking changes.
[PostCSS Has Pseudo] works in all major browsers, including
Internet Explorer 11. With a [Mutation Observer polyfill](https://github.com/webmodules/mutation-observer), the script will work
@@ -238,10 +239,11 @@ ECMA Script:
## CORS
-⚠️ Applies to you if you load CSS from a different domain than the page.
-
-In this case the CSS is treated as untrusted and will not be made available to the JavaScript polyfill.
-The polyfill will not work without applying the correct configuration for CORS.
+> [!IMPORTANT]
+> Applies to you if you load CSS from a different domain than the page.
+>
+> In this case the CSS is treated as untrusted and will not be made available to the JavaScript polyfill.
+> The polyfill will not work without applying the correct configuration for CORS.
Example :
diff --git a/plugins/css-has-pseudo/docs/README.md b/plugins/css-has-pseudo/docs/README.md
index 9b285f09e..a448eeb6a 100644
--- a/plugins/css-has-pseudo/docs/README.md
+++ b/plugins/css-has-pseudo/docs/README.md
@@ -144,8 +144,9 @@ or
```
-⚠️ Please use a versioned url, like this : `https://unpkg.com/@/dist/browser-global.js`
-Without the version, you might unexpectedly get a new major version of the library with breaking changes.
+> [!TIP]
+> Please use a versioned url, like this : `https://unpkg.com/@/dist/browser-global.js`
+> Without the version, you might unexpectedly get a new major version of the library with breaking changes.
[] works in all major browsers, including
Internet Explorer 11. With a [Mutation Observer polyfill](https://github.com/webmodules/mutation-observer), the script will work
diff --git a/plugins/css-prefers-color-scheme/README.md b/plugins/css-prefers-color-scheme/README.md
index 7d6783997..d6cbb1c84 100644
--- a/plugins/css-prefers-color-scheme/README.md
+++ b/plugins/css-prefers-color-scheme/README.md
@@ -150,8 +150,9 @@ or
```
-⚠️ Please use a versioned url, like this : `https://unpkg.com/css-prefers-color-scheme@9.0.0/dist/browser-global.js`
-Without the version, you might unexpectedly get a new major version of the library with breaking changes.
+> [!TIP]
+> Please use a versioned url, like this : `https://unpkg.com/css-prefers-color-scheme@9.0.0/dist/browser-global.js`
+> Without the version, you might unexpectedly get a new major version of the library with breaking changes.
[Prefers Color Scheme] works in all major browsers, including Safari 6+ and
Internet Explorer 9+ without any additional polyfills.
@@ -246,10 +247,11 @@ ECMA Script:
## CORS
-⚠️ Applies to you if you load CSS from a different domain than the page.
-
-In this case the CSS is treated as untrusted and will not be made available to the JavaScript polyfill.
-The polyfill will not work without applying the correct configuration for CORS.
+> [!IMPORTANT]
+> Applies to you if you load CSS from a different domain than the page.
+>
+> In this case the CSS is treated as untrusted and will not be made available to the JavaScript polyfill.
+> The polyfill will not work without applying the correct configuration for CORS.
Example :
diff --git a/plugins/css-prefers-color-scheme/docs/README.md b/plugins/css-prefers-color-scheme/docs/README.md
index 9acebe13c..c6403fb7f 100644
--- a/plugins/css-prefers-color-scheme/docs/README.md
+++ b/plugins/css-prefers-color-scheme/docs/README.md
@@ -73,8 +73,9 @@ or
```
-⚠️ Please use a versioned url, like this : `https://unpkg.com/@/dist/browser-global.js`
-Without the version, you might unexpectedly get a new major version of the library with breaking changes.
+> [!TIP]
+> Please use a versioned url, like this : `https://unpkg.com/@/dist/browser-global.js`
+> Without the version, you might unexpectedly get a new major version of the library with breaking changes.
[] works in all major browsers, including Safari 6+ and
Internet Explorer 9+ without any additional polyfills.
diff --git a/plugins/postcss-color-function/README.md b/plugins/postcss-color-function/README.md
index 44168b62c..0470c54fa 100644
--- a/plugins/postcss-color-function/README.md
+++ b/plugins/postcss-color-function/README.md
@@ -102,7 +102,8 @@ postcssColorFunction({ preserve: true })
The `enableProgressiveCustomProperties` option determines whether the original notation
is wrapped with `@supports` when used in Custom Properties. By default, it is enabled.
-⚠️ We only recommend disabling this when you set `preserve` to `false` or if you bring your own fix for Custom Properties. See what the plugin does in its [README](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-progressive-custom-properties#readme).
+> [!NOTE]
+> We only recommend disabling this when you set `preserve` to `false` or if you bring your own fix for Custom Properties. See what the plugin does in its [README](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-progressive-custom-properties#readme).
```js
postcssColorFunction({ enableProgressiveCustomProperties: false })
diff --git a/plugins/postcss-color-function/docs/README.md b/plugins/postcss-color-function/docs/README.md
index 9a0b22d46..865264872 100644
--- a/plugins/postcss-color-function/docs/README.md
+++ b/plugins/postcss-color-function/docs/README.md
@@ -56,7 +56,8 @@ is preserved. By default, it is not preserved.
The `enableProgressiveCustomProperties` option determines whether the original notation
is wrapped with `@supports` when used in Custom Properties. By default, it is enabled.
-⚠️ We only recommend disabling this when you set `preserve` to `false` or if you bring your own fix for Custom Properties. See what the plugin does in its [README](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-progressive-custom-properties#readme).
+> [!NOTE]
+> We only recommend disabling this when you set `preserve` to `false` or if you bring your own fix for Custom Properties. See what the plugin does in its [README](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-progressive-custom-properties#readme).
```js
({ enableProgressiveCustomProperties: false })
diff --git a/plugins/postcss-color-functional-notation/README.md b/plugins/postcss-color-functional-notation/README.md
index 702ffd4a5..7091fb203 100644
--- a/plugins/postcss-color-functional-notation/README.md
+++ b/plugins/postcss-color-functional-notation/README.md
@@ -88,7 +88,8 @@ postcssColorFunctionalNotation({ preserve: true })
The `enableProgressiveCustomProperties` option determines whether the original notation
is wrapped with `@supports` when used in Custom Properties. By default, it is enabled.
-⚠️ We only recommend disabling this when you set `preserve` to `false` or if you bring your own fix for Custom Properties. See what the plugin does in its [README](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-progressive-custom-properties#readme).
+> [!NOTE]
+> We only recommend disabling this when you set `preserve` to `false` or if you bring your own fix for Custom Properties. See what the plugin does in its [README](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-progressive-custom-properties#readme).
```js
postcssColorFunctionalNotation({ enableProgressiveCustomProperties: false })
diff --git a/plugins/postcss-custom-media/README.md b/plugins/postcss-custom-media/README.md
index 4290866e3..881fec328 100644
--- a/plugins/postcss-custom-media/README.md
+++ b/plugins/postcss-custom-media/README.md
@@ -69,8 +69,9 @@ as these depend on the browser the queries will eventually run in.
_Some of these queries will have only one possible outcome but we have to account for all possible queries in this plugin._
-⚠️ When handling complex media queries you will see that your CSS is doubled for each level of complexity.
-GZIP works great to de-dupe this but having a lot of complex media queries will have a performance impact.
+> [!NOTE]
+> When handling complex media queries you will see that your CSS is doubled for each level of complexity.
+> GZIP works great to de-dupe this but having a lot of complex media queries will have a performance impact.
An example of a very complex (and artificial) use-case :
diff --git a/plugins/postcss-custom-media/docs/README.md b/plugins/postcss-custom-media/docs/README.md
index c48f4c78b..1431300e9 100644
--- a/plugins/postcss-custom-media/docs/README.md
+++ b/plugins/postcss-custom-media/docs/README.md
@@ -62,8 +62,9 @@ as these depend on the browser the queries will eventually run in.
_Some of these queries will have only one possible outcome but we have to account for all possible queries in this plugin._
-⚠️ When handling complex media queries you will see that your CSS is doubled for each level of complexity.
-GZIP works great to de-dupe this but having a lot of complex media queries will have a performance impact.
+> [!NOTE]
+> When handling complex media queries you will see that your CSS is doubled for each level of complexity.
+> GZIP works great to de-dupe this but having a lot of complex media queries will have a performance impact.
An example of a very complex (and artificial) use-case :
diff --git a/plugins/postcss-double-position-gradients/README.md b/plugins/postcss-double-position-gradients/README.md
index 6604ff5db..efcc1d1a8 100644
--- a/plugins/postcss-double-position-gradients/README.md
+++ b/plugins/postcss-double-position-gradients/README.md
@@ -97,7 +97,8 @@ postcssDoublePositionGradients({ preserve: false })
The `enableProgressiveCustomProperties` option determines whether the original notation
is wrapped with `@supports` when used in Custom Properties. By default, it is enabled.
-⚠️ We only recommend disabling this when you set `preserve` to `false` or if you bring your own fix for Custom Properties. See what the plugin does in its [README](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-progressive-custom-properties#readme).
+> [!NOTE]
+> We only recommend disabling this when you set `preserve` to `false` or if you bring your own fix for Custom Properties. See what the plugin does in its [README](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-progressive-custom-properties#readme).
```js
postcssDoublePositionGradients({ enableProgressiveCustomProperties: false })
diff --git a/plugins/postcss-gradients-interpolation-method/README.md b/plugins/postcss-gradients-interpolation-method/README.md
index 8412d0aa4..6ac7234b1 100644
--- a/plugins/postcss-gradients-interpolation-method/README.md
+++ b/plugins/postcss-gradients-interpolation-method/README.md
@@ -37,7 +37,8 @@ npm install @csstools/postcss-gradients-interpolation-method --save-dev
## Shortcomings
-⚠️ Color stops with only a color or only an interpolation hint are not supported.
+> [!CAUTION]
+> Color stops with only a color or only an interpolation hint are not supported.
For best results you should always provide at least the color and position for each color stop.
Double position color stops are supported.
@@ -52,8 +53,9 @@ Double position color stops are supported.
}
```
-⚠️ Variable colors are also not supported.
-We can not mix colors when the color is a variable.
+> [!CAUTION]
+> Variable colors are not supported.
+> We can not mix colors when the color is a variable.
```pcss
.foo {
@@ -129,7 +131,8 @@ postcssGradientsInterpolationMethod({ preserve: false })
The `enableProgressiveCustomProperties` option determines whether the original notation
is wrapped with `@supports` when used in Custom Properties. By default, it is enabled.
-⚠️ We only recommend disabling this when you set `preserve` to `false` or if you bring your own fix for Custom Properties. See what the plugin does in its [README](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-progressive-custom-properties#readme).
+> [!NOTE]
+> We only recommend disabling this when you set `preserve` to `false` or if you bring your own fix for Custom Properties. See what the plugin does in its [README](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-progressive-custom-properties#readme).
```js
postcssGradientsInterpolationMethod({ enableProgressiveCustomProperties: false })
diff --git a/plugins/postcss-gradients-interpolation-method/docs/README.md b/plugins/postcss-gradients-interpolation-method/docs/README.md
index 33c4fdcfd..bb58f6a6f 100644
--- a/plugins/postcss-gradients-interpolation-method/docs/README.md
+++ b/plugins/postcss-gradients-interpolation-method/docs/README.md
@@ -29,7 +29,8 @@
## Shortcomings
-⚠️ Color stops with only a color or only an interpolation hint are not supported.
+> [!CAUTION]
+> Color stops with only a color or only an interpolation hint are not supported.
For best results you should always provide at least the color and position for each color stop.
Double position color stops are supported.
@@ -44,8 +45,9 @@ Double position color stops are supported.
}
```
-⚠️ Variable colors are also not supported.
-We can not mix colors when the color is a variable.
+> [!CAUTION]
+> Variable colors are not supported.
+> We can not mix colors when the color is a variable.
```pcss
.foo {
@@ -83,7 +85,8 @@ is preserved. By default, it is preserved.
The `enableProgressiveCustomProperties` option determines whether the original notation
is wrapped with `@supports` when used in Custom Properties. By default, it is enabled.
-⚠️ We only recommend disabling this when you set `preserve` to `false` or if you bring your own fix for Custom Properties. See what the plugin does in its [README](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-progressive-custom-properties#readme).
+> [!NOTE]
+> We only recommend disabling this when you set `preserve` to `false` or if you bring your own fix for Custom Properties. See what the plugin does in its [README](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-progressive-custom-properties#readme).
```js
({ enableProgressiveCustomProperties: false })
diff --git a/plugins/postcss-lab-function/README.md b/plugins/postcss-lab-function/README.md
index a5e21ec95..c1d67ed64 100644
--- a/plugins/postcss-lab-function/README.md
+++ b/plugins/postcss-lab-function/README.md
@@ -86,7 +86,8 @@ postcssLabFunction({ preserve: true })
The `enableProgressiveCustomProperties` option determines whether the original notation
is wrapped with `@supports` when used in Custom Properties. By default, it is enabled.
-⚠️ We only recommend disabling this when you set `preserve` to `false` or if you bring your own fix for Custom Properties. See what the plugin does in its [README](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-progressive-custom-properties#readme).
+> [!NOTE]
+> We only recommend disabling this when you set `preserve` to `false` or if you bring your own fix for Custom Properties. See what the plugin does in its [README](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-progressive-custom-properties#readme).
```js
postcssLabFunction({ enableProgressiveCustomProperties: false })
diff --git a/plugins/postcss-oklab-function/README.md b/plugins/postcss-oklab-function/README.md
index 6543b063b..6ee6fb545 100644
--- a/plugins/postcss-oklab-function/README.md
+++ b/plugins/postcss-oklab-function/README.md
@@ -95,7 +95,8 @@ postcssOKLabFunction({ preserve: true })
The `enableProgressiveCustomProperties` option determines whether the original notation
is wrapped with `@supports` when used in Custom Properties. By default, it is enabled.
-⚠️ We only recommend disabling this when you set `preserve` to `false` or if you bring your own fix for Custom Properties. See what the plugin does in its [README](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-progressive-custom-properties#readme).
+> [!NOTE]
+> We only recommend disabling this when you set `preserve` to `false` or if you bring your own fix for Custom Properties. See what the plugin does in its [README](https://github.com/csstools/postcss-plugins/tree/main/plugins/postcss-progressive-custom-properties#readme).
```js
postcssOKLabFunction({ enableProgressiveCustomProperties: false })
diff --git a/plugins/postcss-progressive-custom-properties/README.md b/plugins/postcss-progressive-custom-properties/README.md
index 1e59a3e47..9b3b68abb 100644
--- a/plugins/postcss-progressive-custom-properties/README.md
+++ b/plugins/postcss-progressive-custom-properties/README.md
@@ -6,8 +6,9 @@
[PostCSS Progressive Custom Properties] is a utility plugin to correctly declare Custom Property fallbacks and enhancements.
-⚠️ It is not intended to be used directly by stylesheet authors.
-Meant to be included in other PostCSS plugins that provide CSS value transforms as fallbacks.
+> [!WARNING]
+> It is not intended to be used directly by stylesheet authors.
+> Meant to be included in other PostCSS plugins that provide CSS value transforms as fallbacks.
[Custom Properties are not discarded like regular declarations when invalid.](https://www.w3.org/TR/css-variables-1/#invalid-variables)
This makes it tricky to provide fallback values for older browsers.
diff --git a/plugins/postcss-selector-not/README.md b/plugins/postcss-selector-not/README.md
index 07f702ba3..687c6872d 100644
--- a/plugins/postcss-selector-not/README.md
+++ b/plugins/postcss-selector-not/README.md
@@ -20,8 +20,9 @@ p:not(:first-child):not(.special) {
}
```
-⚠️ Only lists of simple selectors (`:not(.a, .b)`) will work as expected.
-Complex selectors (`:not(.a > .b, .c ~ .d)`) can not be downgraded.
+> [!CAUTION]
+> Only lists of simple selectors (`:not(.a, .b)`) will work as expected.
+> Complex selectors (`:not(.a > .b, .c ~ .d)`) can not be downgraded.
## Usage
diff --git a/plugins/postcss-selector-not/docs/README.md b/plugins/postcss-selector-not/docs/README.md
index aa0bcea8d..77b256996 100644
--- a/plugins/postcss-selector-not/docs/README.md
+++ b/plugins/postcss-selector-not/docs/README.md
@@ -27,8 +27,9 @@
```
-⚠️ Only lists of simple selectors (`:not(.a, .b)`) will work as expected.
-Complex selectors (`:not(.a > .b, .c ~ .d)`) can not be downgraded.
+> [!CAUTION]
+> Only lists of simple selectors (`:not(.a, .b)`) will work as expected.
+> Complex selectors (`:not(.a > .b, .c ~ .d)`) can not be downgraded.