+
HDS is awesome
```
-Regular tailwindCss colors aren't available. You can only use colors defined in HDS with this pattern.
+Regular TailwindCSS colors aren't available.
```hbs preview-template
-
+
TailwindCSS colors won't work
```
-### Other tokens
+### HDS core styles
-Other tokens than colors are available via the provided `hds`-[helper-classes](https://design-system-components-hashicorp.vercel.app/foundations/typography) made available via `@hashicorp/design-system-tokens`.
+HDS core styles are available via the provided `hds`-[utility-classes](https://design-system-components-hashicorp.vercel.app/foundations/typography) made available via `@hashicorp/design-system-tokens`.
-You for example would work with HDS' typography tokens in this way:
+You for example would work with HDS' typography styles in this way:
```hbs preview-template
-
+
A paragraph styled via HDS.
```
+Because HDS provides utility classes for core styles, you should not be using Tailwind classes to customize core styles like typography.
+
### Combining HDS and Tailwind
-Because we are working with a customized tailwind configuration it is easy to combine HDS design tokens with regular tailwind utility classes:
+Tailwind is used as a supplement to what HDS provides. You will be using Tailwind for layouting and other utility functionality that isn't provided by HDS.
```hbs preview-template
-