5.8 KiB
Please use the template that's relevant for your situation and delete the other templates. If this is just a noredink-ui repo doc change, you don't need to follow a template.
🏷️ Bump for version VERSION_NUMBER
What changes does this release include?
The easiest and most reliable way to find the changes that this release includes is to go through the changes between the last version number and master: https://github.com/NoRedInk/noredink-ui/compare/VERSION_NUMBER...master.
Include links to the relevant PRs in a list in this PR. Be sure to note any risky changes or changes that you will want to alert QA to when upgrading to the new version of noredink-ui.
Please update the PR's name to include a quick note about every linked PR.
How has the API changed?
Please paste the output of elm diff run on latest master in the code block:
Releasing
After this PR merges, and you've pulled down latest master, finish following the publishing process.
🌟 Adding a new component
About the component
What is the purpose of the new component? When and where will it be used? How will the reviewer know if this component meets the success criteria?
Please link to any relevant context and stories.
🖼️ What does this change look like?
- Follow the the Guidelines for an optimal design ping to add helpful screenshots/videos for design.
- @ mention the design team on this PR to request approval on your changes. A designer will "thumbs up" react to your PR if they approve it, or will leave comments if it's not quite approved yet.
Component completion checklist
- I've gone through the relevant sections of the Development Accessibility guide with this component in mind
- Component has clear documentation
- Component is in the Component Catalog
- Component is categorized reasonably (see Category for all the currently available categories). The component can be in multiple categories, if appropriate.
- Component has a representative preview for the Component Catalog cards (bonus points for making it delightful!)
- Component has a customizable example. Aim for having every possible supported version of the component displayable through the configuration on this page. (Protip: This is handy for testing expected behavior!)
- The customizable example produces sample code
- The component's example page includes keyboard behavior, if any
- The component's example page includes guidance around how to use the component, if necessary
- Component is tested
- axe checks and percy snapshots will be automatically added for every component. However, if you want to customize when the checks and snapshots are made, you will need to make changes to script/puppeteer-tests.js.
- there are 2 ways to add Elm tests:
- if you want to test the Component Catalog example directly, add ProgramTest-style tests under
component-catalog/tests - if you want to test the component directly, add tests under
tests/Spec. Historically, this has been the more popular Elm testing strategy for noredink-ui.
- if you want to test the Component Catalog example directly, add ProgramTest-style tests under
- Component API follows standard patterns in noredink-ui
- e.g., as a dev, I can conveniently add an
nriDescription - and adding a new feature to the component will not require major API changes to the component
- e.g., as a dev, I can conveniently add an
- Please assign team-accessibilibats-a11ybats as a reviewer in addition to assigning a reviewer from your team
🔧 Modifying a component
Context
Please link to any relevant context and stories.
🖼️ What does this change look like?
- Follow the the Guidelines for an optimal design ping to add helpful screenshots/videos for design.
- @ mention the design team on this PR to request approval on your changes. A designer will "thumbs up" react to your PR if they approve it, or will leave comments if it's not quite approved yet.
Component completion checklist
- I've gone through the relevant sections of the Development Accessibility guide with the changes I made to this component in mind
- Changes are clearly documented
- Component docs include a changelog
- Any new exposed functions or properties have docs
- Changes extend to the Component Catalog
- The Component Catalog is updated to use the newest version, if appropriate
- The Component Catalog example version number is updated, if appropriate
- Any new customizations are available from the Component Catalog
- The component example still has:
- an accurate preview
- valid sample code
- correct keyboard behavior
- correct and comprehensive guidance around how to use the component
- Changes to the component are tested/the new version of the component is tested
- Component API follows standard patterns in noredink-ui
- e.g., as a dev, I can conveniently add an
nriDescription - and adding a new feature to the component will not require major API changes to the component
- e.g., as a dev, I can conveniently add an