finos / a11y-theme-builder

DesignOps toolchain theme builder for accessibility inclusion using Atomic Design.
Apache License 2.0
33 stars 68 forks source link

[DOCS] Lack of information for designer about design system used and familiarity with design tokens so good documentation in needed #865

Open ravjot07 opened 3 weeks ago

ravjot07 commented 3 weeks ago

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:

Design Token Guide:

-Clear definition of what design tokens are and their value.

aaronreed708 commented 1 week ago

@ravjot07 can we close this?

ravjot07 commented 1 week ago

no sir i will add more prs to add more documentation in this topics