From b07f9e994e2d4cfeb3d54649105b90d161aa37da Mon Sep 17 00:00:00 2001 From: "Jens W. Klein" Date: Thu, 21 Mar 2024 13:45:36 +0100 Subject: [PATCH] Update docs/source/contributing/style-guide.md Co-authored-by: Steve Piercy --- docs/source/contributing/style-guide.md | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/docs/source/contributing/style-guide.md b/docs/source/contributing/style-guide.md index 8728e97f082..ee982f8da03 100644 --- a/docs/source/contributing/style-guide.md +++ b/docs/source/contributing/style-guide.md @@ -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 ` +Check out Quanta's appearance in this PDF: {download}`Quanta Spring 2021 `. 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. @@ -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.