a11y-theme-builder icon indicating copy to clipboard operation
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

Open ravjot07 opened this issue 9 months ago • 2 comments

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.).

ravjot07 avatar May 07 '24 11:05 ravjot07