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

Public resources for building on and in support of VA.gov. Visit complete Knowledge Hub:
https://depo-platform-documentation.scrollhelp.site/index.html
281 stars 196 forks source link

Define content standards: Preparing content for translation #21103

Open DanielleThierryUSDSVA opened 3 years ago

DanielleThierryUSDSVA commented 3 years ago

User story

As a VA.gov writer, I need to understand how to write in a way that will allows my content to be easily translated into other languages.

Issue description

Research, define, and document how to prepare English content for ease of translation. Next step will be considering what to add to style guide specifically, and how to best socialize.

Related documentation

Checklist in progress: https://github.com/department-of-veterans-affairs/va.gov-team/blob/master/products/content/spanish-translation/coronavirus-mvp/preparing-content-for-translation.md

moviedosoco commented 3 months ago

Hi @RLHecht. I finished making the edits. I have also added the missing examples. This is ready for you to review and confirm the examples to add them to the checklist. Please see the link below. Thank you!

https://docs.google.com/document/d/1PQ3FkfxqxRDYnLMlSbbJ39B89NYUNnY1kfovgo8K04M/edit#heading=h.4enc4unuuc82

RLHecht commented 3 months ago

Thanks so much @moviedosoco. I think it's really helpful adding the examples you did and the links to the other pages. I just went through the comments again and made a few more edits on the page. Do you want to make these edits into a branch of the GH doc and you can have Danielle review it?

moviedosoco commented 3 months ago

@RLHecht You're welcome! I've already made some of the edits in GH and will do the new ones. I also shared the Google Docs with Danielle for her review.

moviedosoco commented 1 month ago

@DanielleThierryUSDSVA Hello Danielle, I realized I didn't share with you the Google document properly in this section. Please see the link below for your review. Thank you! https://docs.google.com/document/d/1PQ3FkfxqxRDYnLMlSbbJ39B89NYUNnY1kfovgo8K04M/edit#heading=h.4enc4unuuc82