Product support team did a consistency audit to identify the components/patterns that are outdated or inconsistent that leads to support and inconsistency.
How might we ensure that both engineers and designers are able to find and implement the correct components and patterns for their features/products.
Hypothesis or Bet
How will this initiative impact the quality of VFS or VSP teams' work?How will this initiative be easy for VFS or VSP teams? Or how will it be easier than what they did before?
If we have more robust documentation of established components and patterns, VSP will be giving less support to VFS teams.
If we have more robust documentation, VFS teams will be able to identify the correct component or pattern to use right away.
We will know we're done when... ("Definition of Done")
What requirements does this project need to meet for you to finish this initiative?
[ ] Updated documentation of established components and form patterns
[ ] Closing consistency audit tickets
[ ] VFS team is using component and pattern documentation to identify the form to use
Launch Checklist
Is this service / tool / feature...
Tool
... tested?
[ ] Usability test (TODO: link) has been performed, to validate that new changes enable users to do what was intended and that these changes don't worsen quality elsewhere. If usability test isn't relevant for this change, document the reason for skipping it.
[ ] ... and issues discovered in usability testing have been addressed.
Note on skipping: metrics that show the impact of before/after can be a substitute for usability testing.
[ ] End-to-end manual QA or UAT is complete, to validate there are no high-severity issues before launching
[ ] (if applicable) New functionality has thorough, automated tests running in CI/CD
[ ] (if applicable) Post to #vsp-service-design for external communication about this change (e.g. VSP Newsletter, customer-facing meetings)
... measurable
[ ] (if applicable) This change has clearly-defined success metrics, with instrumentation of those analytics where possible, or a reason documented for skipping it.
Closing this epic as the team worked on improving consistency across design.va.gov, Storybook and Sketch library so most of these issues should have been resolved from that work.
Problem Statement
Product support team did a consistency audit to identify the components/patterns that are outdated or inconsistent that leads to support and inconsistency.
How might we ensure that both engineers and designers are able to find and implement the correct components and patterns for their features/products.
Hypothesis or Bet
How will this initiative impact the quality of VFS or VSP teams' work? How will this initiative be easy for VFS or VSP teams? Or how will it be easier than what they did before?
If we have more robust documentation of established components and patterns, VSP will be giving less support to VFS teams.
If we have more robust documentation, VFS teams will be able to identify the correct component or pattern to use right away.
We will know we're done when... ("Definition of Done")
What requirements does this project need to meet for you to finish this initiative?
Launch Checklist
Is this service / tool / feature...
Tool
... tested?
... documented?
products/platform/PRODUCT_NAME/
platform/PRODUCT_NAME/README.md
platform/PRODUCT_NAME/
, unless you already have another location for it... measurable
Required Artifacts
Documentation
PRODUCT_NAME
: directory name used for your product documentationTesting
Measurement
TODOs