Skip to content

Commit

Permalink
Update docs/source/contributing/style-guide.md
Browse files Browse the repository at this point in the history
Co-authored-by: Steve Piercy <[email protected]>
  • Loading branch information
jensens and stevepiercy committed Mar 21, 2024
1 parent 2b20e10 commit b07f9e9
Showing 1 changed file with 8 additions and 7 deletions.
15 changes: 8 additions & 7 deletions docs/source/contributing/style-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,24 +19,25 @@ Volto, and thus Plone 6, underwent a gradual evolution of its design system over

## Volto and Pastanaga UI

Around 2017, Albert Albert Casado Celma introduced Pastanaga UI, which became Volto's default theme UI/UX.
Around 2017, Albert Casado Celma introduced Pastanaga UI, which became Volto's default theme UI/UX.
Despite being unfinished, it provided valuable resources and patterns gradually integrated into Volto.
Albert has played a crucial role in refining Volto's UI/UX, offering valuable insights and guidance.
As mentioned earlier, design systems evolve over time based on user feedback and changing needs.

## Tooling around a design system

Volto adopted some time ago [Storybook](https://storybook.js.org), a tool that is specific for build and show off the visual elements that a design system has in isolation.
Storybook provides a sandbox to build and test these visual elements (components) in isolation, mock them to show different data and test edge cases and at the same time document them, on how to instantiate them and use them for the developers' own benefit.
Volto adopted some time ago [Storybook](https://storybook.js.org), a tool that interactively displays the visual elements of a design system.
Storybook provides a sandbox to build and test these visual elements (components) in isolation, mock them to show different data, and test edge cases.
At the same time, Storybook documents components for how to instantiate them and use them in development.

Not all Volto's visual components are covered yet in Storybook, but it has already a good foundation.
Look at the current components [Storybook build](https://6.docs.plone.org/storybook).

## Quanta, the design system for Plone 7

Recently, Albert updated Pastanaga UI to align with current trends and feedback, creating Quanta a version 2.0 of Pastanaga UI.
Recently, Albert updated Pastanaga UI to align with current trends and feedback, creating Quanta, a version 2.0 of Pastanaga UI.
This reflects ongoing refinement and enhancement of the design system.
Check out Quanta's appearance in this PDF: {download}`Quanta Spring 2021 <Quanta.pdf>`
Check out Quanta's appearance in this PDF: {download}`Quanta Spring 2021 <Quanta.pdf>`.

Its implementation has been challenging due to the community's emphasis on stability and the lack of demand from projects.
While Quanta offers significant improvements, updating JavaScript and CSS poses a barrier for many.
Expand All @@ -53,5 +54,5 @@ In the meantime, for upcoming projects, Volto with Pastanaga UI remains the reco

## Help to make Quanta a reality

Do you want to help Quanta a reality?
Just ping the Volto Team at GitHub or in the [Plone organization Discord](https://plone.org/community/chat) channel `#frontend-volto` to ask for access to the Quanta specs and how to help.
Do you want to help Quanta become a reality?
Just ping the Volto Team on GitHub or in the [Plone organization Discord](https://plone.org/community/chat) channel [`#frontend-volto`](https://discord.com/channels/786421998426521600/787308038050545666) to ask for access to the Quanta specs and how to help.

0 comments on commit b07f9e9

Please sign in to comment.