From d901d20c5eb72246d17f64234b3cfa855a5a278d Mon Sep 17 00:00:00 2001 From: Dylan Kelly Date: Fri, 23 Jun 2023 00:21:50 +1000 Subject: [PATCH] docs: :memo: update project README.md --- README.md | 56 +++++++++++++++--- .../public/assets/img/ripple-header-title.png | Bin 0 -> 24704 bytes 2 files changed, 48 insertions(+), 8 deletions(-) create mode 100644 docs/public/assets/img/ripple-header-title.png diff --git a/README.md b/README.md index 5efab82ad7..2dff357fc9 100644 --- a/README.md +++ b/README.md @@ -1,22 +1,62 @@ -# Ripple 2.0 -Ripple branding header made up of different decorative shapes +Ripple framework - - + + ripple docs - - + + + ripple storybook + + ripple ui core npm + + +# Ripple 2.0 + +# Table of Contents +- [Ripple 2.0](#ripple-20) +- [Table of Contents](#table-of-contents) + - [About the project](#about-the-project) + - [Ripple Framework](#ripple-framework) + - [Documentation](#documentation) + - [Contributing](#contributing) + - [License](#license) + ## About the project -Ripple is the presentation layer for building websites on the DPC [Single Digital Presence](https://www.vic.gov.au/single-digital-presence) platform. +Ripple is the design system for Victorian government digital products. + +Ripple is a system of reusable styles, components, patterns and tools for building brand Victoria digital products. Developed by the Single Digital Presence (SDP) team within the Department of Government Services, Ripple strives to: + +- make it easier for citizens to find, understand and use government information +- ensure users can easily navigate sites regardless of technical ability, location or device +- allow designers and developers to create consistent Brand Victoria digital products +- increase the speed of delivery for digital products and services + +Over 50 government websites use Ripple to date, including our main vic.gov.au platform. These sites attract the visitation of millions of views per month. + + +### Ripple Framework + +The Ripple design system consists of the design elements and components used to build websites using the Victorian government brand and Ripple _framework_, a collection of [Nuxt 3](https://www.ripple.sdp.vic.gov.au/framework/key-concepts/nuxt/) modules and [layers](https://www.ripple.sdp.vic.gov.au/framework/key-concepts/nuxt-layers) primarily used to create headless SDP websites using the [Tide Drupal CMS](https://github.com/dpc-sdp/tide). + + +## Documentation + +See https://www.ripple.sdp.vic.gov.au/ for more information about the Ripple design system. + +For information about using Ripple in SDP websites see the [Ripple Framework](https://www.ripple.sdp.vic.gov.au/framework) section. + + +## Contributing -_Ripple 2_ is a ground-up redevelopment using the newest versions of Vue and Nuxt. This project is still a work in progress, please [read the announcement](https://github.com/dpc-sdp/ripple-framework/discussions/69) for further details. +Please see [CONTRIBUTING.md](CONTRIBUTING.md) as well as https://www.ripple.sdp.vic.gov.au/design-system/develop/contributing/ for information about how to submit changes to Ripple. ## License diff --git a/docs/public/assets/img/ripple-header-title.png b/docs/public/assets/img/ripple-header-title.png new file mode 100644 index 0000000000000000000000000000000000000000..17405790b6ca65594563eb37f07953c05f709feb GIT binary patch literal 24704 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