diff --git a/packages/design-docs/src/tokens/TokenValue.tsx b/packages/design-docs/src/tokens/TokenValue.tsx
index 51524638b58..a8bc4c9f3d2 100644
--- a/packages/design-docs/src/tokens/TokenValue.tsx
+++ b/packages/design-docs/src/tokens/TokenValue.tsx
@@ -106,7 +106,7 @@ export function TokenList({
{utils.getDisplayName(token.name)}
-
+
{utils.getScssName(token.name)}
diff --git a/packages/design-docs/src/types.d.ts b/packages/design-docs/src/types.d.ts
new file mode 100644
index 00000000000..7af1f75f758
--- /dev/null
+++ b/packages/design-docs/src/types.d.ts
@@ -0,0 +1 @@
+declare module 'color-contrast-checker';
diff --git a/packages/design-system/src/stories/clickable/About.mdx b/packages/design-system/src/stories/clickable/About.mdx
index a57d8ebce98..825be640379 100644
--- a/packages/design-system/src/stories/clickable/About.mdx
+++ b/packages/design-system/src/stories/clickable/About.mdx
@@ -12,7 +12,7 @@ Clickables are just the things that look like buttons. It's a UI pattern that ha
## Buttons
-[Checkout the Button docs here.](/docs/components-clickable-buttons-button--variations)
+[Checkout the Button docs here.](/docs/clickable-button--docs)
Use `Button` when you need highly readable CTAs that trigger an action on the page.
@@ -22,7 +22,7 @@ Use `Button` when you need highly readable CTAs that trigger an action on the pa
## ButtonAsLinks
-[Checkout the ButtonAsLink docs here.](/docs/components-clickable-buttons-buttonaslink--variations)
+[Checkout the ButtonAsLink docs here.](/docs/clickable-buttonaslink--docs)
Use `ButtonAsLink` when you need a CTA that will navigate to a new page.
@@ -32,7 +32,7 @@ Use `ButtonAsLink` when you need a CTA that will navigate to a new page.
## ButtonIcon
-[Checkout the ButtonIcon docs here.](/docs/components-clickable-buttons-buttonicon--variations)
+[Checkout the ButtonIcon docs here.](/docs/clickable-buttonicon--docs)
Use `ButtonIcon` when you need to click on a standalone icon. This should never be a hyperlink.
diff --git a/packages/design-system/src/stories/clickable/Button.mdx b/packages/design-system/src/stories/clickable/Button.mdx
index 635ff39f05f..874e2eaf50a 100644
--- a/packages/design-system/src/stories/clickable/Button.mdx
+++ b/packages/design-system/src/stories/clickable/Button.mdx
@@ -28,7 +28,7 @@ Buttons are clickable items used for actions. They can have different styles dep
Coral supports two button sizes: `M` and `S`.
-The small size can only display icons from [SizedIcon's "S" batch](/docs/components-icon-sizedicon--icon-xs).
+The small size can only display icons from [SizedIcon's "S" batch](/docs/icons-sizedicon--docs).
### Variations
@@ -101,7 +101,7 @@ Use `SkeletonButton` or `Skeleton variant="button"` to represent a placeholder f
-[The Skeleton Documentation is over there!](/docs/components-skeleton--skeleton-button-story)
+[The Skeleton Documentation is over there!](/docs/feedback-skeleton--docs)
### Button tooltips
diff --git a/packages/design-system/src/stories/clickable/ButtonAsLink.mdx b/packages/design-system/src/stories/clickable/ButtonAsLink.mdx
index b804658d885..bebe6f1374a 100644
--- a/packages/design-system/src/stories/clickable/ButtonAsLink.mdx
+++ b/packages/design-system/src/stories/clickable/ButtonAsLink.mdx
@@ -16,7 +16,7 @@ import * as ButtonStories from './Button.stories';
Despite your complete reliance on best practices, you may be forced into situations that require a button that is actually a link.
-Their abilities are the same as the [Button component](/docs/components-clickable-buttons-button--variations) with exceptions:
+Their abilities are the same as the [Button component](/docs/clickable-button--docs) with exceptions:
- `ButtonAsLink` components can't be in the "loading" state
- `ButtonAsLink` components can't be in the "disabled" state
@@ -106,7 +106,7 @@ Use the same Skeletons as `Button`.
-[The Skeleton Documentation is over there!](/docs/components-skeleton--skeleton-button-story)
+[The Skeleton Documentation is over there!](/docs/feedback-skeleton--docs)
### Button tooltips
@@ -118,7 +118,7 @@ ButtonsAsLinks can also have a tooltip on hover displaying additional descriptio
## Content
-The rules of `Button` apply here as well. You'll [find them here](/docs/components-clickable-buttons-button--variations#content).
+The rules of `Button` apply here as well. You'll [find them here](/docs/clickable-button--docs#content).
## Usage
diff --git a/packages/design-system/src/stories/clickable/ButtonIcon.mdx b/packages/design-system/src/stories/clickable/ButtonIcon.mdx
index 58d0144196d..4fd9f24e0c2 100644
--- a/packages/design-system/src/stories/clickable/ButtonIcon.mdx
+++ b/packages/design-system/src/stories/clickable/ButtonIcon.mdx
@@ -95,7 +95,7 @@ Skeleton needs are handled by the Skeleton component. Use `SkeletonButtonIcon` o
-[The Skeleton Documentation is over there!](/docs/components-skeleton--skeleton-button-story)
+[The Skeleton Documentation is over there!](/docs/feedback-skeleton--docs)
## Interaction
diff --git a/packages/design-system/src/stories/clickable/Dropdown.mdx b/packages/design-system/src/stories/clickable/Dropdown.mdx
index 0b7884a6239..c63329262ee 100644
--- a/packages/design-system/src/stories/clickable/Dropdown.mdx
+++ b/packages/design-system/src/stories/clickable/Dropdown.mdx
@@ -115,7 +115,7 @@ Dropdowns have two parts: a disclosure and a popover.
**Disclosure**
-The disclosure can be any `Clickable` element. [You can find them here.](/docs/components-clickable-buttons-about--button-variations)
+The disclosure can be any `Clickable` element. [You can find them here.](/docs/clickable-about--docs)
The `isDropdown` props of `Button` is mandatory.
diff --git a/packages/design-system/src/stories/clickable/Link.mdx b/packages/design-system/src/stories/clickable/Link.mdx
index 8e6f24cc714..3feaccfd69c 100644
--- a/packages/design-system/src/stories/clickable/Link.mdx
+++ b/packages/design-system/src/stories/clickable/Link.mdx
@@ -17,7 +17,7 @@ import * as StoriesButton from './LinkAsButton.stories';
Link is used for navigation.
-If you use a link for triggering an action on the page, you must consider using a [Button](/docs/components-clickable-buttons-button--variations) instead.
+If you use a link for triggering an action on the page, you must consider using a [Button](/docs/clickable-button--docs) instead.
Still need to be convinced? Please, take the time to read [this article written by Marcy Sutton](https://marcysutton.com/links-vs-buttons-in-modern-web-applications).
diff --git a/packages/design-system/src/stories/form/About.mdx b/packages/design-system/src/stories/form/About.mdx
index f5b5d3e7707..87ac1d1357e 100644
--- a/packages/design-system/src/stories/form/About.mdx
+++ b/packages/design-system/src/stories/form/About.mdx
@@ -13,7 +13,7 @@ The library provides a collection of fields, mostly applying our design language
We do however extend standard fields with prefix and affix support, error management and built-in labels.
-[Learn more about the fields here.](/docs/components-form-form-fields-about--form-field-error)
+[Learn more about the fields here.](/docs/form-fields--docs)
## Layout elements
@@ -23,7 +23,7 @@ A very `low-opinion` component, `Form` can easily be replaced by the html `form`
Using `Form` will grant you a ready-made flex layout with a `spacing-s` gap for your fields.
-[Browse the Form documentation for examples.](/docs/components-form-form--form-skeleton)
+[Browse the Form documentation for examples.](/docs/form-form--docs#skeleton)
### The `Fieldset` component
@@ -31,7 +31,7 @@ Neatly wrap together your fields with the `Fieldset` component.
It provides an enforced gap between children fields but can also sport a `legend` prop for better contextualization.
-[Browse the Fieldset documentation for examples.](/docs/components-form-form-fieldset--default-story)
+[Browse the Fieldset documentation for examples.](/docs/form-fieldset--docs)
### The `Row` component
@@ -55,4 +55,4 @@ In both cases, a gap of `spacing-l` is enforced between the fields.
An opinionated layout component, `Button`'s mission is to enforce the placement of the form's actions.
-[Browse the Buttons documentation for examples.](/docs/components-form-form-buttons--form-buttons-skeleton)
+[Browse the Buttons documentation for examples.](/docs/form-buttons--docs)
diff --git a/packages/design-system/src/stories/form/Buttons/FormButtons.mdx b/packages/design-system/src/stories/form/Buttons/FormButtons.mdx
index 9df64f63bd7..e4cf0b2d4d5 100644
--- a/packages/design-system/src/stories/form/Buttons/FormButtons.mdx
+++ b/packages/design-system/src/stories/form/Buttons/FormButtons.mdx
@@ -23,7 +23,7 @@ A Form always displays buttons in order to be cancelled or validated.
## Style
-- The gap between buttons should be `spacing-m` ([read the tokens doc here](/docs/design-tokens-light-measures--page)).
+- The gap between buttons should be `spacing-m` ([read the tokens doc here](/docs/design-tokens-measures--docs)).
## States
diff --git a/packages/design-system/src/stories/form/Field/FormField.mdx b/packages/design-system/src/stories/form/Field/FormField.mdx
index 19a61112f19..f998d236f9a 100644
--- a/packages/design-system/src/stories/form/Field/FormField.mdx
+++ b/packages/design-system/src/stories/form/Field/FormField.mdx
@@ -11,7 +11,7 @@ import * as Stories from './FormField.stories';
# Form Fields common rules
-A Form Field features a label, an input and an optional [small inline message](docs/components-inline-message--default-demo) for text-based inputs.
+A Form Field features a label, an input and an optional [small inline message](docs/messaging-inlinemessage--docs) for text-based inputs.
## Zoning
diff --git a/packages/design-system/src/stories/form/Field/Input/Input.Copy.mdx b/packages/design-system/src/stories/form/Field/Input/Input.Copy.mdx
index 1bc65417c97..55d2ae51e22 100644
--- a/packages/design-system/src/stories/form/Field/Input/Input.Copy.mdx
+++ b/packages/design-system/src/stories/form/Field/Input/Input.Copy.mdx
@@ -46,7 +46,7 @@ A shortcut to a read-only `Form.Text` field with prefix and a state, it's used t
-Read the [Affixes documentation here](/docs/components-form-form-fields-prefix-suffix--quick-start) for more details.
+Read the [Affixes documentation here](/docs/form-affic-affixes) for more details.
## Interactions
diff --git a/packages/design-system/src/stories/form/Form.mdx b/packages/design-system/src/stories/form/Form.mdx
index 1fdca7c7ee6..cd6c9419691 100644
--- a/packages/design-system/src/stories/form/Form.mdx
+++ b/packages/design-system/src/stories/form/Form.mdx
@@ -27,7 +27,7 @@ The `Form` component is a slightly opinionated `