Contributing

Making suggestions

The design system exists in GitHub to encourage collaborative work. If something can be better, it should be made better.

Content recommendations go through the Web Content Managment Committee, all other recommendations go through Web Development.

If comfortable with GitHub, make a pull request with details for why the change should be made.

Writing for the design system

These guidelines are borrowed from the wonderfully written principles at Vue.js.

Testing requirements

All code must be tested against the following environments. All HTML, CSS, and JS techniques must have 98% coverage based on caniuse.com using the past full semester’s statistics from the main website (or the Health Sciences Library website for HSL).

All code must function or meaningfully and gracefully degrade on these platforms using the listed tool combinations.

Screen reader combinations from WebAIM's Screen Reader User Survey published 22 February 2024.

Last updated: 19 May 2025

Desktop combinations

Mobile