cfpb / sbl-project

Project management repo for the SBL project
Creative Commons Zero v1.0 Universal
0 stars 1 forks source link

[Epic] Navigation #157

Open angelcardoz opened 4 months ago

angelcardoz commented 4 months ago

Milestone: [Link to milestone] Add a few sentences to describe the milestone.

Epic: Navigation

Overview

Tasks

Use the following checklist to ensure each epic is built out properly. If needed, you can add or remove items.

User stories

MVP (Beta release)

Step indicator

Header

Footer

Backlog (post-MVP)

Step indicator

Requirements

Technical

Step indicator

Content

Step indicator

User testing

Research goals

Step indicator

Task ideation

Step indicator

Current mock-ups

Updated: MM/DD/YYYY

Page name Page name Page name
Image Image Image
natalia-fitzgerald commented 4 months ago

Discovery:

Step indicator (also called progress indicator) and navigation

The CFPB does not have a step or progress indicator component so we had initially planned to use the current USWDS step indicator as a starting point and apply CFPB styles (font, state colors, etc). The USWDS step indicator component is specifically designed/intended for a linear flow (complements a back/next navigation in a linear sequence). It is not intended for a non-linear progressions or interactions that might be completed in any order. According to the usage guidelines, the USWDS step indicator should not be used for navigation. A user should navigate using back/next or something equivalent (within the page content). The step indicator is a purely visual marker that indicates where a user is within the linear flow (as opposed to one a user can interact with as a form of navigation).

Step indicator (based on USWDS component)

Progress indicator (Carbon Design)

Stepped progression (Goldman Sachs)

Progress Indicators

Alternatives to the step indicator

Although I strongly support the idea of a linear flow for the small business lending filing flow, I did want to present some alternative components that allow a user to complete a set of tasks in any order. Neither of these alternatives provide a user with any feedback as to progress toward an end goal.

Side navigation (CFPB component)

Decision: Linear flow of sequential steps

At yesterday's design/dev sync we discussed the idea of a linear (versus an open-ended flow). We decided that, for a number of reasons, a linear flow makes a lot of sense for the small business lending filing process. While there are steps within the filing process that could be completed in a different order there are certain steps that must happen before others. In deciding on a flow it is beneficial to design a system that is consistent so that a user knows what to expect. Existing steps that are not order-dependent can always be moved later if testing shows user friction. But, upload must always come before errors and warnings can be shown and before a user can view a summary and submit their filing for the year.

We did want to be able to provide the user with a way to access the "warnings" before they resolve their "errors." A user will be able to access a report of all "errors" and "warnings" by clicking a link at the top of the "Resolve errors" step.

natalia-fitzgerald commented 4 months ago

@dan-padgett Here are my initial thoughts regarding the step indicator styling.

Step indicator states

The USWDS has the following 3 states built into their Step indicator component:

Definition of complete (by step)

To complete the step a user must complete the action(s) and click the button to move to the next step.

Something to figure out:

@billhimmelsbach