department-of-veterans-affairs / vets-design-system-documentation

Repository for design.va.gov website
https://design.va.gov
36 stars 55 forks source link

Experimental Design [Returning a copy of the submission on confirmation] #2767

Open eileen-coforma opened 3 weeks ago

eileen-coforma commented 3 weeks ago

What

Change the confirmation page pattern to include the ability to:

  • Download a PDF copy of submitted form (which may have a delay for generation)
  • Review the data submitted within the form in plain language
  • Include more accurate form status language in alert and what to expect next sections

Purpose

What problem does this component or pattern solve for the user? Today, when Veterans file an appeal on va.gov, there is no way for them to maintain a record of their submission. To increase Veteran trust of the reliability of our products, we want to provide the ability to retain a copy of a submitted appeal, so Veterans can store it in their personal records.

PDFs generated for submission tend to be inaccessible, because they are flattened to pass through downstream services. As an alternative, we want to provide the same information for review on the confirmation page itself, so Veterans have a chance to retain that information either by printing, copying, or saving the page.

Usage

Context or task: Explain the scenario or user tasks where this component is, or could be, used.

At the end of forms, when PDFs are generated or data is transmitted on behalf of the Veteran.

Behavior

Describe the key interactions for this component, calling out any specific considerations for mobile.

Changes in the template which will now include the following:

Examples

Include any examples you have of this component or pattern. These can be screenshots, links to a Sketch file, or links to staging or production.

FIGMA prototype

Accessibility

Include any accessibility considerations.

  • Use unordered list to pair populated form data, instead of using headers

Guidance

What would you want to tell other teams about this component or pattern?

  • When possible, after a Veteran fills out a form on VA.gov, they get a copy of their filled out form returned to them after submission.
  • On the confirmation page, provide a link to download a PDF copy of the submission (PDF would follow the same fillable PDF template, but with answers generated within the space).
  • On the confirmation page, provide a plain-text HTML version of the review page that includes a list of all the questions and answers and list of uploaded file names, separated by sections.
  • On the confirmation page, provide the ability to print the entire page, hiding unnecessary actions (ie. PDF download link and print button).

Research (optional)

Include any research you have already conducted, or plan to conduct, on this component or pattern.

Accessible copy of completed submission research folder

Code (optional)

Include any existing code.

Next steps

You may present your work to the Design System Council at an upcoming meeting. If you do not or cannot attend the Design Council Meeting, you can opt to get an asynchronous approval.

Submit requests to join an upcoming Design System Council meeting in #platform-design-system.

During the meeting, the Design System Council Working Group will evaluate the request and make a decision.

If your request is approved, you can add your component or pattern to the system. If you have any questions on how to add your component or pattern to the system, please reach out to the Design System Team at #platform-design-system.

lropp commented 2 weeks ago

The Accredited Representative Management crew in Benefits Portfolio would be interested in this update if approved!

caw310 commented 2 weeks ago

On the agenda for the 5/2/24 DSC meeting.

saderagsdale commented 2 weeks ago

@caw310 Thanks! Any way you can share with me an invitation to that meeting? (sade.ragsdale@coforma.io)