Skip to content

Latest commit

 

History

History
232 lines (136 loc) · 13 KB

UX-Documentation.md

File metadata and controls

232 lines (136 loc) · 13 KB

Return to Directory

UX & UI Design Documentation

Index

  1. User Research
  2. Usability Testing
  3. UI Design System
  4. Content Strategy

User Research

Initial Discovery

UX Research Approach

  • Our guiding principles and general approach to user research, especially related to the discovery phase, and including planned deliverables.

USTC Staff UX Research Plan

  • Comprehensive plan of initial discovery research with all court user groups.

UX Discovery Research Findings

  • We conducted several days of onsite user research with approx. 24 court users. It consisted of a focus group that helped map out the end-to-end journey of a case that's filed, as well as one-on-one interviews with court users about their daily tasks, how they use the system, and future needs.

UX Discovery Personas

Targeted Discovery

IRS Interview (June 2019)

Deep dive interviews with 2 IRS attorneys and 2 administrative staff probing on their interactions with the Tax Court, internal and shared business processes, and their needs from the new CMS

IRS User Interview - Plan

IRS Attorney User Interviews - Findings

Judge User Interviews (June 2019)

Judge User Interviews Plan

Judge User Interviews (June 2019) - Findings

User Management Interviews (March 2021)

Docket Clerk Interview Guide

PR 65 Research Interviews - Recommendations

Continuous Research

Post-launch, the team continues with research and testing activities.

Continuous Research Plan

User Flows

These document the user flow of the new system we are building. It's a work-in-progress, that's updated to include the new workflows that we developed.

Create a New Case (Paper Petition)

Create and Save Order/Notice

Add Docket Entry User Flows

Add Docket Entry and Serve - Court-Issued Documents

Add Docket Entry - Externally Filed Paper Documents

Messaging User Flows

Trial Session User Flows

Usability Testing

Case Form Usability Testing (January 2019)

Conducting usability testing with pro se petitioners (public) on the Start a Case form design and user flow.

Case Form Usability Test - Petitioner - Test Plan

Case Form Usability Test - Petitioner - Findings

Petition QC Usability Testing (March 2019)

In this study, Flexion UX Designers tested the Petitions QC Workflow in a development environment for the first time. Previously, the team conducted several iterative design studies with Petitions Clerks using Figma wireframes.

Petitions Workflow Usability Study Findings

Practitioner Interviews / Usability Testing (April 2019)

In this study, Flexion UX Designers interviewed current practitioners to understand their use of the existing Tax Court system. The Flexion UX Team then tested the new Case Form with the practitioners, as well as the file document functionality for the first time.

Core System Usability Testing (September 2019)

In this comprehensive study, Flexion UX Designers performed a usability study with several user groups to test the core system functionality implemented to date. This study included all major user roles, including both internal and external users.

Petition Clerk Research Plan

Docket Clerk Research Plan

Calendar Clerk Research Plan

Judge Research Plan

Petitioner Research Plan

IRS Attorney Research Plan

Core System Usability Testing - Findings

Petitioner Usability Testing (October 2019)

In this study, Flexion UX Designers performed a usability study with potential petitioners to test the petitioner dashboard and file a petition flow.

File a Petition Usability Test - Plan

File a Petition Usability Test - Findings

Docket Clerk Usability Testing (January 2020)

In this study, Flexion UX Designers observed Docket Clerks performing their normal job functions to test end-to-end processes using the new CMS.

Docket Clerk Usability Testing - Findings

Cooperative Usability Testing (January 2020)

In this study, Flexion UX Designers performed an end-to-end testing of a U.S. Tax Court case workflow in order to validate system features and handoffs between roles at the Court.

A modified methodology for cooperative usability testing was used to meet our unique needs. Users performed their daily tasks and then reflected with the entire group on the experience.

Roundtable Cooperative Usability Testing - Findings

Pro-Se Petitioner: Create Case Usability Testing (May, 2020)

In this study, Flexion UX Designers performed usability testing for creating a case as a pro-se petitioner. Goals focused on validating iterative design choices from the previous usability study and testing specifically on a mobile device.

File a Petition Usability Test - Petitioner - Plan

File a Petition Usability Test - Petitioner - Findings

Order Search Research

Order Search Interviews (March 2021)

User Interview Mural Board

Order Search Findings March 2021

Order Search Recommendations July 2021

Sealing/Unsealing Research

Sealing/Unsealing Cases and Documents (November 2021)

UX Sealing/Unsealing Research Plan October 2021

UX Sealing/Unsealing Research Findings Report November 2021

User Interview Mural Board

Consolidation Research

Consolidation Discovery Research (March-November 2022)

UX Consolidation Research Plan - Docket Clerks March 2022

Docket Clerk Process Flow - November 2022 Deliverable

UX Consolidation Research Plan - Judges/CAs/Other Chambers July 2022

UX Consolidation Findings Report - Judges/CAs/Other Chambers August 2022

UX Consolidation Research Plan - Trial Clerks October 2022

UX Consolidation Findings Report - Trial Clerk November 2022

User Interview Mural Board - All user types

Petition's QC Research

Petition's QC - Petition's Clerks (February-March 2023)

UX Petition's QC Research Plan - Petition's Clerks February 2023

UX Petition's QC Findings Report - Petition's Clerks March 2023

User Interview Mural Board - Petition's Clerks

QC Process Flow Lucid Chart - Petition's Clerks

UI Design System

The complete USTC UI Design Kit is available as a Figma file

Generally follows the UI patterns and components established in the U.S. Web Design System (USWDS) version 3 with some exceptions and additions

Content Strategy

Voice & Tone

When communicating to the public, we want to maintain a friendly, direct tone. Break things down into pieces and steps as much as possible. Simplify legalese into more plain language and known terminology, except when law or Court policies dictate specific language must be used.

Use plain language for error messages, alerts, and instructions so users can clearly understand what is happening.

Language and Writing Guidelines

  • Generally follows AP style
  • Use Title case for headers (all)
  • (Exception) - Use sentence case for headers in page-level success/alert/error messages.
  • Use sentence case for field labels and any other body copy content (all)
  • (Exception) - Use title case for document type and document titles
  • Use Title case for buttons
  • Use MM/DD/YY for dates
  • (Exception) - If date is part of concatenated document title, date is MM-DD-YYYY
  • Use contractions whenever possible
  • Spell out "number" or use "No" as abbreviation
  • Use serial/Oxford commas
  • Display dollar amounts with decimals ($60.00)
  • Time displayed as 3:45 pm ET
  • Error messages should be clear directions/verb phrases of what the user needs to do e.g., "Enter state" or "Select trial city" without periods at the end

System-Generated PDFs

  • for content, use one space after a period punctuation

Success and error messages

  • Always appear at the top of the screen, under the Case detail page header (docket number) with user always scrolled back to the top
  • Include summary of what's happened as well as instructions or messages about what to do next
  • All success and error messages have the manual "dismiss" action EXCEPT validation errors, which disappear after the action has been re-tried and no more errors exist