Skip to content

LG-10850 Update all screens to say 5 to 10 days to get a letter#9224

Merged
soniaconnolly merged 19 commits intomainfrom
sonia-lg-10850-5-10-days
Sep 19, 2023
Merged

LG-10850 Update all screens to say 5 to 10 days to get a letter#9224
soniaconnolly merged 19 commits intomainfrom
sonia-lg-10850-5-10-days

Conversation

@soniaconnolly
Copy link
Contributor

@soniaconnolly soniaconnolly commented Sep 15, 2023

🎫 Ticket

LG-10850

🛠 Summary of changes

Update translations for the following screens that mention the length of time for Verify by Mail:

  • Welcome
  • Phone Warning
  • Phone Error
  • Request Letter
  • Resend Letter
  • Letter Enqueued
  • Enter Code
  • Didn't Get Your Letter
  • Mail Only Warning

📜 Testing Plan

  • Create account, start IdV
  • Check Welcome screen
  • Enter phone number to fail Phone Step (703-555-5555)
  • Check Phone Warning and Phone Error screens
  • Enter Verify By Mail flow
  • Check Request Letter and Letter Enqueued screens
  • Check Enter Code and Didn't Get Your Letter screen (add parameter of ?did_not_receive_letter=1 to url)
  • Click to resend letter and check Resend Letter screen
  • In application.yml set vendor_status_sms: full_outage and restart server
  • Cancel and restart IdV and check Mail Only Warning screen

👀 Screenshots

After, Welcome:
Details
English Spanish French
Welcome en Welcome es Welcome fr
After, MailOnlyWarning:
Details
English Spanish French
Mail Only Warning en Mail Only Warning es Mail Only Warning fr
After, Phone Warning:
Details
English Spanish French
Phone Warning en Phone Warning es Phone Warning fr
After, Phone Error:
Details
English Spanish French
Phone Error en Phone Error es Phone Error fr
After, Request Letter:
Details
English Spanish French
Request Letter en Request Letter es Request Letter fr
After, Letter Enqueued:
Details
English Spanish French
Letter Enqueued en Letter Enqueued es Letter Enqueued fr
After, Enter Code:
Details
English Spanish French
Enter Code en Enter Code es Enter Code fr
After, Didn't Get Letter:
Details
English Spanish French
Didn't Get Letter en Didn't Get Letter es Didn't Get Letter fr
After, Send Another Letter:
Details
English Spanish French
Send Another Letter en Send Another Letter es Send Another Letter fr

@soniaconnolly soniaconnolly requested a review from a team September 15, 2023 23:55
@zachmargolis
Copy link
Contributor

I don't expect this will change often, but seeing as we're changing this in a bunch of places, should we make these numbers configs and interpolate them in?

@soniaconnolly
Copy link
Contributor Author

I don't expect this will change often, but seeing as we're changing this in a bunch of places, should we make these numbers configs and interpolate them in?

We're not changing how the app behaves, since these numbers depend on USPS. Just changing how we talk about it. I don't think a config makes sense in this case.

@zachmargolis
Copy link
Contributor

I don't expect this will change often, but seeing as we're changing this in a bunch of places, should we make these numbers configs and interpolate them in?

We're not changing how the app behaves, since these numbers depend on USPS. Just changing how we talk about it. I don't think a config makes sense in this case.

In my mind, it's not about app behavior, it's about "don't repeat yourself" or "one source of truth" kind of maintainability wins

@soniaconnolly
Copy link
Contributor Author

In my mind, it's not about app behavior, it's about "don't repeat yourself" or "one source of truth" kind of maintainability wins

Agree in general about having things in one place. For this change, it wouldn't have helped to have the numbers as configs, because we also changed from "business days" to "days". We could have one translation tag for "5 to 10 days" and one for "up to 10 days" and interpolate those in, but for translations we generally prefer repetition as far as I've seen to avoid unexpected results from one screen to another. Are there other examples of reused translation phrases?

@zachmargolis
Copy link
Contributor

I was focused more on the numbers. But we do make sure to interpolate "Login.gov" everywhere as APP_NAME / %{app_name}, entire phrases don't make for good constants because not all languages have the same word/phrase boundaries/ability to combine

@soniaconnolly
Copy link
Contributor Author

I was focused more on the numbers. But we do make sure to interpolate "Login.gov" everywhere as APP_NAME / %{app_name}, entire phrases don't make for good constants because not all languages have the same word/phrase boundaries/ability to combine

Agreed about whole phrases. Do you still want me to interpolate the numbers? I'm willing to do it.

@zachmargolis
Copy link
Contributor

I was focused more on the numbers. But we do make sure to interpolate "Login.gov" everywhere as APP_NAME / %{app_name}, entire phrases don't make for good constants because not all languages have the same word/phrase boundaries/ability to combine

Agreed about whole phrases. Do you still want me to interpolate the numbers? I'm willing to do it.

I think it's worth a shot at least! I wouldn't consider it a hard requirement for this PR but I do think it would be more maintainable going forwards.

@soniaconnolly
Copy link
Contributor Author

soniaconnolly commented Sep 18, 2023

I think it's worth a shot at least! I wouldn't consider it a hard requirement for this PR but I do think it would be more maintainable going forwards.

I put in JIRA ticket LG-11048 and put in the notes we discussed in chat. It feels like a lot to add that to this PR, especially since it wasn't about just changing the numbers.

Copy link
Contributor

@solipet solipet left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sonia and I walked through all the screens and corrected the very few issues we found.

LGTM!

@soniaconnolly soniaconnolly merged commit 02ff8b2 into main Sep 19, 2023
@soniaconnolly soniaconnolly deleted the sonia-lg-10850-5-10-days branch September 19, 2023 22:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants