From e1a5c3bef92feeec8123be77e09ea435df7a1a45 Mon Sep 17 00:00:00 2001 From: Jim Bumgardner Date: Wed, 6 Sep 2023 13:06:01 -0700 Subject: [PATCH] Updated readme. --- README.md | 27 +++------------------------ 1 file changed, 3 insertions(+), 24 deletions(-) diff --git a/README.md b/README.md index de0df280..54421e06 100644 --- a/README.md +++ b/README.md @@ -1,26 +1,17 @@ -# California Design System README +# ODI Innovation Hub README -## About the California Design System +## About the ODI Innovation Hub ### Status This project is currently in early beta status. It’s used in production on a few sites while we learn and continuously improve. Part of our early beta includes learning and collaborating with teams. As the project matures we’ll share more details on how we might meld the design system components into the State template. -### Why a design system -We built this to address common needs identified by California's Office of Digital Innovation (ODI) and the California Department of Technology (CDT) during development of alpha.ca.gov, covid19.ca.gov, cannabis.ca.gov, and drought.ca.gov. - ### How we work We start by understanding the needs of residents of California through user research. We use an iterative design and development process to provide services that meet these needs. As we work, we continue to test our principles, designs, and components. We prioritize equity to some degree by ensuring that our code is accessible and performant for all devices and bandwidths. Components pass through stages of alpha, beta and production as they become available to the Design System. We work in the open: all our code and issue tracking is public. We’re happy to review pull requests from the public and state employees. Anyone can file an issue with bug reports and feature requests by selecting the **New issue** button from our issues page. You can see the prioritized list of issues we’re addressing on our project board. -## Be a part of the Design System - -We’re looking for partners to share feedback and improve the Design System. - -Reach out to us through the contact form if you’d like to work with us. Or, participate through this GitHub repository. - ## Development instructions This project is a collection of components. This means the individual widgets are easy to iterate on in isolation, upgrade individually, or exclude from a project. @@ -31,16 +22,6 @@ To run this project locally, checkout this repo and run these commands: This will start up a local server running the site you see at designsystem.webstandards.ca.gov. -You can find the components in the `/components` directory. The README for each component is used to create the pages in the Components section. Interactive versions of each component are included in these pages. - -Each component is published to npm. The following steps are run in a pre-publish hook in the package.json script. New versions will not publish unless these steps complete: -- The sample markup in the README is matched to the sample markup used in the automated test -- Any build steps like JavaScript concatenation or Sass compilation are run and resulting files are stored in the /dist folder -- Automated tests are run including an axe accessibility checker -- The latest version of the component is written to our CDN so it can be included with a script tag - -We welcome your component modification requests or suggestions. Create a pull request or open an issue in this repository. - ### End to end testing Playwright is used to run end to end and accessibility tests against local site urls using axe. @@ -67,9 +48,7 @@ These component unit tests were created following design system site. Any modification to a component's code or documentation should be associated with a new version of the component being published. Publishing a new version of a component to npm will run the scripts that publish its code to the CA CDN. More information on component development in the component readme. - -The rest of the site content is in ```/docs``` +The site content is in ```/docs``` - ```/docs/pages```: markdown for additional pages - ```/docs/site```: templates for site layouts - ```/docs/src/css/sass/index.scss```: site CSS dependencies