a11y-theme-builder
a11y-theme-builder copied to clipboard
[DOCS] Lack of information for designer about design system used and familiarity with design tokens so good documentation in needed
Problem/Concern
As a designer, its hard finding it challenging to integrate effectively with the project due to:
Unclear Design System Overview: Since high-level understanding of the design system's structure (components, styles, etc.) or where to find existing resources to use this project effectively.
Design Token Confusion: The concept of design tokens is unfamiliar, and lack of guidance on how they're used within the project and their benefits for streamlining design work.
Proposed Solution
Create a dedicated "Design System" section within the project's documentation. This section could include:
Design System Introduction:
- A brief explanation of Atomic Design and how the project uses it.
Design Token Guide:
-Clear definition of what design tokens are and their value.
- A list of available tokens (name, value, use cases).
- Instructions on how to use tokens practically within design tools (Figma plugin, etc.).