Document copy/translation/i18n/PO file process

[machikoyasuda]

closes #1446

What this PR does

• Non-technical doc to document how we divide the responsibilities (Product, Design, Engineering) of getting application copy drafted, edited, approved, designed into Figma, translated, and finally, into the application in English and Spanish.
• Most importantly, this page will have the link to the spreadsheet, that holds the English and Spanish translations -- so we don't have to get lost in Google Drive or various GitHub issues to find it.
• This PR also updates Engineering's i18n docs with our new processes

Process

• @machikoyasuda to start off the doc file
• @machikoyasuda to move the file to /docs/
• @machikoyasuda to hand-off iBabbleOn process to @indexing
• @indexing to review

[machikoyasuda]

@indexing I started the Markdown file.

Please propose changes by making a GitHub comment on the line (or adding a suggestion commit https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/commenting-on-a-pull-request#adding-comments-to-a-pull-request, like I did here: https://github.com/cal-itp/benefits/pull/1447/files#r1239300498), and I can merge the suggestions in.

[thekaveman]

These docs are super helpful!

Can I suggest/request that we move them into a page in our /docs folder so they show up in the https://docs.calitp.org/benefits site and are more easily accessible for everyone? Maybe under the Configuration section?

We can still use the README in /benefits/locale to link to this online documentation (see an example of this pattern in the /terraform directory)

[thekaveman]

Need to add a reminder to run bin/makemessages.sh: #1436 (comment)

[thekaveman]

Now that #1571 is done, engineers should be editing copy directly in the app for English, then running bin/makemessages.sh, then updating the corresponding Spanish in the PO file.

[machikoyasuda]

Updated in the dev i18n docs: https://github.com/cal-itp/benefits/pull/1447/files#diff-739a6fd0a2d16786a1fad0499fde882753fee93043bb1f8b1a4b03ba5c75ea06

[machikoyasuda]

Current status

• @indexing and @machikoyasuda met today to hand-off iBabbleOn process to @indexing
• Once Andy re-formats the Google Spreadsheet to fit the translation needs, sends the request, receives the requested translations and hands the translations back to Dev, he can update the documentation for full deatils
• Discussed how and where the new variables should be kept. Andy decided not to worry about getting the new variables ready and translated in this round. The variables can be written and translated in the next next round. I believe we have all the variable data for MST, SacRT, Veterans except for the [card functionality].. but I'm not 100% sure.

- [affected service]: public transportation or light rail or bus service
- [action]: reduce
- [rate of discount]: 50%
- [transit type]: fixed routes
- [card functionality]: tap this card when you get on and off the bus

[machikoyasuda]

Lots of new stuff here: #1410 (comment)

[machikoyasuda]

NIST is el Instituto Nacional de Estándares y Tecnología
Source: https://login.gov/es/who-uses-login/
https://github.com/18F/identity-site/blob/50e1724eaf00dba130375886b9d683a71c8d8b29/content/_landing/who_uses_login._es.md?plain=1#L24

[machikoyasuda]

@indexing This page is ready for your review: https://github.com/cal-itp/benefits/pull/1447/files#diff-def4742fd8f91b94db56a5c970797fe316f277c2d0e2604c0e3ac1bd2c2edb8d

[machikoyasuda]

@thekaveman @angela-tran Please review the updated i18n dev docs https://github.com/cal-itp/benefits/pull/1447/files#diff-739a6fd0a2d16786a1fad0499fde882753fee93043bb1f8b1a4b03ba5c75ea06

I tried covering all the new processes, but let me know if I'm missing anything!

[thekaveman]

Minor nit about an internal link, but otherwise this is great and I'd say let's get it published!