The Clarity documentation is located at clarity.design. The documentation site documents all aspects of Clarity which includes the following:
- Design Guidelines
- Accessibility Guidelines
- Component Usage
To add new documentation or fix existing documentation you will need to run our development environment on your computer. You will need to have NodeJS preinstalled as well as Git Source Control.
-
Fork the Clarity Repository using you Github account.
-
Clone the Clarity Repository
## Clone your forked repository git clone [email protected]:<github username>/core.git ## Navigate to the directory cd clarity ## Set name and e-mail configuration git config user.name "John Doe" git config user.email [email protected] ## Setup the upstream remote git remote add upstream https://github.com/vmware-clarity/core.git ## Check out the upstream a topic branch for your changes git fetch git checkout -b topic/feature-name upstream/topic/feature-name
-
Install Clarity Dependencies
npm install
-
Start the Storybook
npm run start
-
See changes in your browser at
localhost:8080
Once you have made the changes and are happy with the results you can submit and open a Pull Request by following our Development Contribution Guidelines.