refactor: after review

README.md

@@ -316,8 +316,7 @@ If your component requires additional styling (which most likely is the case), e
 component's directory `/src/MyComponent/index.scss` which by default contains an empty class for your component.
 
 If you wish to use CSS variables (which is the preferred way of styling the components since values can be
-easily overridden and customized by the consumers of Paragon), create specific design tokens in `tokens` directory (in the `core` and `themes` directories) and then generate (`npm run build-tokens`) CSS variables for your component.
-This way the variables will also get automatically picked up by documentation site and displayed on your component's page.
+easily overridden and customized by the consumers of Paragon), you can do so by utilizing [design tokens](/tokens).
 
 **Please note that you need to follow [Paragon's CSS styling conventions](docs/decisions/0012-css-styling-conventions).**
 

tokens/README.md

@@ -1,7 +1,6 @@
 # Design Tokens
 
-This module is responsible for handling design tokens in Paragon, for rationale behind design tokens see [Scaling Paragon's styles architecture with design tokens](https://openedx.atlassian.net/wiki/spaces/BPL/pages/3630923811/Scaling+Paragon+s+styles+architecture+with+design+tokens)
-and relevant ADR(TODO: add link when we merge an ADR). 
+This module is responsible for handling design tokens in Paragon, for rationale behind design tokens see [Scaling Paragon's styles architecture with design tokens](https://openedx.atlassian.net/wiki/spaces/BPL/pages/3630923811/Scaling+Paragon+s+styles+architecture+with+design+tokens). 
 
 ## Overview
 

www/src/pages/tools/component-generator.mdx

@@ -72,8 +72,7 @@ If your component requires additional styling (which most likely is the case), e
 component's directory `/src/MyComponent/index.scss` which by default contains an empty class for your component.
 
 If you wish to use CSS variables (which is the preferred way of styling the components since values can be
-easily overridden and customized by the consumers of Paragon), create specific design tokens in `tokens` directory (in the `core` and `themes` directories) and then generate (`npm run build-tokens`) CSS variables for your component.
-This way the variables will also get automatically picked up by documentation site and displayed on your component's page.
+easily overridden and customized by the consumers of Paragon), you can do so by utilizing [design tokens](/tokens).
 
 **Please note that you need to follow [Paragon's CSS styling conventions](https://github.com/openedx/paragon/blob/master/docs/decisions/0012-css-styling-conventions).**