Skip to content

Commit 1b89ed6

Browse files
committed
fix: Update docs with scenario example
1 parent 1b38ac1 commit 1b89ed6

File tree

1 file changed

+5
-1
lines changed

1 file changed

+5
-1
lines changed

TRANSLATION_WORKFLOW.md

+5-1
Original file line numberDiff line numberDiff line change
@@ -212,14 +212,18 @@ This is a case we hopefully wouldn’t run into, since we are constantly keeping
212212

213213
If the file can be identified and has not been labelled as a COMPLETED entry in the DB AND the file cannot be found in the TV UI as complete or listed as IN_PROGRESS, our current fix is to delete the file entry in the DB and let the process start from the beginning for this particular file by manually triggering an upload/queue of the file impacted.
214214

215-
### A file errors during deserialization.
215+
### A file errors during deserialization (Check status of translation jobs).
216216

217217
Individual files won't be marked as `ERRORED` in the DB the same way Jobs will be. In order to see a list of files that have errored during the fetch/deserialization process (the "Check status of translation jobs" github action) a NRQL query can be run in the NR staging env:
218218

219219
`SELECT slug, locale from TranslationWorkflowError where target = 'file' and workflow = 'checkTranslationsAndDeserialize' since 1 month ago limit 100`
220220

221221
When this occurs, we'll need to update the translation engine being used in TV. This is usually done by our i18n specialist.
222222

223+
#### Example:
224+
225+
In some jp files, we've seen issues where `</a>` tags have been moved to the beginning of some blocks of code they were meant to close. This breaks the deserialization process and keeps the file in TV vs getting PR'd. This has led to us deleting said file and attempting to retrigger the process via a manual trigger, or updating the html file in TV and manually checking the file status via a triggering of the "Check status of translation jobs" action.
226+
223227
# Key concepts / Glossary
224228

225229
## GitHub Branches and Pull Requests

0 commit comments

Comments
 (0)