Summarise approach and decisions for internationalisation in the Design System backlog

alphagov / govuk-frontend

GOV.UK Frontend contains the code you need to start building a user interface for government platforms and services.

https://frontend.design-system.service.gov.uk/

MIT License

1.18k stars 325 forks source link

Summarise approach and decisions for internationalisation in the Design System backlog #2749

Closed vanitabarrett closed 1 year ago

vanitabarrett commented 2 years ago

What

Write up a summary of our final approach for internationalisation and why we decided to follow that approach. Might also be a good opportunity to talk about the other things we tried and explain why those don't work. Also anything we've decided not to do (e.g: because it's not part of our MVP solution; because it's out of scope).

Why

We should try and be transparent about the decisions we make, to help people understand why we've done things a certain way. This may also help as somewhere to refer people to if we get questions on support.

Who needs to work on this

Content, Developer

Who needs to review this

Content, Developer

Done when

[ ] On Github, add backlog comment in backlog, e.g https://github.com/alphagov/govuk-design-system-backlog/issues/99

kellylee-gds commented 1 year ago

From mid-sprint review:

Look through Google Drive for relevant documentation related to i18n. Pull information from docs we think will be useful to users
Check whether we have guidance in internal docs about how to translate components (if not, this feels like it's own card tbh)
Use decision summaries published previously as a template for recording this information (eg Cookie Banner)

@claireashworth

claireashworth commented 1 year ago

Draft sent for comment and review.

kellylee-gds commented 1 year ago

This reads really well to me, thanks for sharing @claireashworth. @romaricpascal please can you also review.

romaricpascal commented 1 year ago

That was some thorough gathering of all the I18n related issues! Cheers @claireashworth! Added a couple of comments on the doc so we can clarify a few things and then we should be in a good place.

claireashworth commented 1 year ago

We just need to decide where we're publishing this information. I previously suggested adding it to this conversation thread - https://github.com/alphagov/govuk-design-system-backlog/issues/99 Any other thoughts?

36degrees commented 1 year ago

I think the backlog issue makes as much sense as anywhere.

I have added a few (hopefully minor!) comments to the Google Doc, but generally think it's looking really good. Thanks for doing all the hard work to pull all of that together, @claireashworth! 🙌🏻

claireashworth commented 1 year ago

Comments completed and summary published on #99 'Supporting multiple languages'.