department-of-veterans-affairs / va.gov-cms

Editor-centered management for Veteran-centered content.
https://prod.cms.va.gov
GNU General Public License v2.0
98 stars 69 forks source link

Standardize Hours component across Facilities #8821

Closed kevwalsh closed 1 year ago

kevwalsh commented 2 years ago

User Story or Problem Statement

Hours fields in the content model [Airtable view of hours fields](https://airtable.com/appSg80z9nVWoesxn/tblPdSdScGDeV1Y6f/viwWLkczMV4fvcj7R?blocks=hide) VA_gov_CMS_content_model_documentation__Fields_-_Airtable

Discovery into current state

  1. Screenshots of every Hours experience on the FE, annotated with content type, example URLs, and number of instances.
  2. Screenshots of every CMS form, from a non-admin perspective, placed beside the corresponding FE screenshot
  3. Consider grouping these into two broad collections (Hours fields that use Facility API, vs editor-contributed)

FE Design

  1. Standardize the FE experience as much as possible, w/r/t to labels, spacing, padding, etc.
  2. Contribute a component to design system? (Stretch)

CMS design for editor-contributed data

  1. Should we require a value on every row
  2. Experience when each row is required - UX labels,
  3. Experience for time pickers (separate issue?)
  4. Any help text
  5. (Stretch) Blue sky the design for Hours widget, including things like Google's "copy" functionality, which is available in our Drupal contrib module.

CMS design for fields with upstream data source

  1. What should this look like?
Screenshots from Google and Slack ![image](https://user-images.githubusercontent.com/643678/164260865-5e3dc98b-e249-473c-9855-dca8849623d3.png) Slack___Scheduled___CivicActions___17_new_items Slack's hour picker. 30 minute increments but let's the editor override with the keyboard. Slack___Scheduled___CivicActions___17_new_items

Acceptance Criteria

Implementation steps

## Design principles Veteran-centered - [ ] `Single source of truth`: Increase reliability and consistency of content on VA.gov by providing a single source of truth. - [ ] `Accessible, plain language`: Provide guardrails and guidelines to ensure content quality. - [ ] `Purposely structured content`: Ensure Content API can deliver content whose meaning matches its structure. - [ ] `Content lifecycle governance`: Produce tools, processes and policies to maintain content quality throughout its lifecycle. Editor-centered - [ ] `Purpose-driven`: Create an opportunity to involve the editor community in VA’s mission and content strategy goals. - [ ] `Efficient`: Remove distractions and create clear, straightforward paths to get the job done. - [ ] `Approachable`: Offer friendly guidance over authoritative instruction. - [ ] `Consistent`: Reduce user’s mental load by allowing them to fall back on pattern recognition to complete tasks. - [ ] `Empowering`: Provide clear information to help editors make decisions about their work. ### CMS Team Please check the team(s) that will do this work. - [ ] `Sitewide program` - [ ] `Platform CMS Team` - [ ] `Sitewide crew ` (leave Sitewide unchecked and check the specific team instead) - [ ] `⭐️ Content ops` - [ ] `⭐️ CMS experience` - [ ] `⭐️ Public websites` - [x] `⭐️ Facilities` - [ ] `⭐️ User support`
swirtSJW commented 2 years ago

Most are are using line labels of "Mon." but the facilities are using "Mon:" which seems better. Which ever is chosen, we will need to standardize image

Non-related guidance https://design.va.gov/content-style-guide/dates-and-numbers#:~:text=Mon.%2C%20Tue.%2C%20Wed.%2C%20Thu.%2C%20Fri.%2C%20Sat.%2C%20Sun.

related discussion

davidmpickett commented 1 year ago

Closing as all issues are complete