diff --git a/packages/css/src/components/gap/README.md b/packages/css/src/components/gap/README.md index 2c2cecdc25..71f49666d9 100644 --- a/packages/css/src/components/gap/README.md +++ b/packages/css/src/components/gap/README.md @@ -19,7 +19,9 @@ The five sizes of [Component Space](/docs/brand-design-tokens-space--docs) are a ## Guidelines - Use this utility class to vertically separate the children of a parent element from each other. -- It can be used on any element and sets the `gap` CSS property. +- Do not use it on the Grid component. + Grid is responsible for its own gaps. +- It can be used on any other element and sets the `gap` CSS property. It also makes the element a grid container; the gap would be ignored otherwise. These declarations are marked with the `!important` flag to ensure they override any other gaps and display modes. - To add a gap between 2 siblings, the first one can be given a [Margin Bottom](/docs/utilities-css-margin--docs) instead. diff --git a/packages/css/src/components/grid/README.md b/packages/css/src/components/grid/README.md index d9ea3c7e55..17f541da97 100644 --- a/packages/css/src/components/grid/README.md +++ b/packages/css/src/components/grid/README.md @@ -17,6 +17,8 @@ Multiple instances of the grid component are possible on a page, but the columns Within the grid, you create cells containing the desired content. A cell often spans multiple columns of the grid. +The Gap utility classes must not be used on the Grid component. + ## Design The [design choices](/docs/brand-design-tokens-grid--docs) are described in the general documentation.