Navrhněte překladovou pipeline
Propojte změny zdroje s použitelnými překlady a jasně stanovte odpovědnost, kontrolu, doručování i obnovu.
Překladová pipeline je úplná teprve tehdy, když se změna zdroje promění v použitelný obsah v systému, který ho potřebuje. Generování je jen jednou z jejích částí. Workflow musí také určit správnou revizi, načíst její cílové překlady, zachovat schválenou práci a rozhodnout, co lze publikovat.
Při návrhu začněte jedním konkrétním typem obsahu: katalogy v repozitáři, články v CMS nebo aplikačními záznamy. Za každý z nich odpovídá někdo jiný a každý se doručuje jinak. Workflow, které se všemi třemi zachází stejně, může zastřít rozhodnutí, na nichž závisí, zda lze výsledek bezpečně použít.
Určete, kdo odpovídá za každý přechod #
Návrh pro katalogy v repozitáři může zahrnovat tato rozhodnutí:
| Přechod | Rozhodnutí |
|---|---|
| Zdroj splní podmínky pro překlad | Překládejte zkontrolovaný zdroj ze zaznamenaného commitu pomocí důvěryhodného spouštěče, který vylučuje vygenerované cílové překlady. |
| Práce začíná | Použijte výslovně určený lokalizační engine, jazyky, formát a schválené výchozí verze; pokud je vyžadováno schválení spuštění, zajistěte ho. |
| Cílové překlady splní podmínky přijetí | Pověřené osoby zkontrolují požadované změny a nevyřešené případy zůstanou viditelné. |
| Výstup se vrací | Stažené a ověřené soubory prostředků se zahrnou do pull requestu s překlady. |
| Obsah se dostává ke čtenářům | Změna je přijata do vydání aplikace a projde kontrolami souborů prostředků. |
| Výsledek je třeba vrátit zpět | Obnovte prokazatelně funkční soubory prostředků a příslušnou konfiguraci nebo výchozí verze. |
Jde o příklad návrhu workflow, nikoli o výchozí nastavení produktu. U každého rozhodnutí uveďte konkrétní mechanismus, který zajišťuje jeho dodržení. Pokud dodržování týmového pravidla nehlídá automatická kontrola, určete člověka, který ho ověří.
Vybírejte nástroje podle toho, za co odpovídají #
Nativní integrace může zajišťovat spouštěče poskytovatele a zpětný zápis v rámci oprávnění udělených při instalaci. Prostředí, ve kterém běží CLI, odpovídá za lokální načítání a commity. Klient volající API odpovídá za revize, které ukládá, a za aktivaci výstupu. Vyberte podporovaná rozhraní a pravidla jejich fungování tak, aby těmto odpovědnostem odpovídala.
Studio spravuje konfiguraci překladů a rozhodnutí; DevTools zajišťuje programové spouštění a zpracování souborů; Radar poskytuje dostupné podklady z měření a šetření. Tyto možnosti můžete kombinovat. Nejde o povinné kroky, které je třeba zavádět jeden po druhém.
Prostudujte si ruční a automatické režimy zvoleného poskytovatele, práci s koncepty, přístupová oprávnění a důsledky odpojení. Připojení, které publikuje do CMS, má jiný bod přijetí výstupu než připojení, které otevírá pull request v repozitáři.
Zachovejte vazby mezi revizemi #
Uchovávejte společně identitu obsahu, revizi zdroje, cílový jazyk, revizi výstupu nebo artefakt, konfiguraci a stav přijetí. Rozhodněte, co se stane, pokud během překladu nebo kontroly dorazí novější verze zdroje. Starší výsledek se nesmí stát aktuálním jen proto, že se dokončí jako poslední.
Určete, kde má opakované použití zachovat schválené cílové překlady a kde se mají vygenerovat nové. Podpora stejného formátu neznamená, že API, CLI a aplikace nabízejí stejné možnosti. V návrhu zohledněte přesnou výchozí verzi použitou volajícím i chování při vynucení.
Připravte postup pro nevyřešené případy #
Stanovte, co se stane při odmítnutí vstupu, selhání cílového překladu, přerušení načítání, čekání na kontrolu, lokálním konfliktu nebo nejednoznačné odpovědi. Další krok má obnovit již evidovanou práci podle pravidel příslušného rozhraní, ne vše spouštět znovu jen proto, že se ztratilo potvrzení.
Některé dokončené cílové překlady už mohou být připravené k doručení, zatímco jiný zůstává nevyřešený. Rozhodněte, zda vydání vyžaduje všechny, nebo může záměrně použít náhradní variantu. Pravidla kontroly určují, co se stane, když chybí rozhodnutí nebo vyprší časový limit. Řízení běhu ponechte nástroji, který za práci odpovídá, místo abyste zaváděli univerzální akci pro opakování.
Zajistěte, aby šly podklady o kvalitě správně vyhodnotit #
Stanovte otázky, které jsou pro vydání důležité, a to i u překladů vytvořených mimo Lingo.dev. Měření může odhalit práci, která vyžaduje kontrolu, aniž by se tím stalo systémem odpovědným za schválený obsah nebo rozhodování o publikování.
Návrh měření vysvětluje kritéria, podklady, stavy odpovědí a skupiny zahrnuté do reportů. V rámci workflow určete lidi, kteří budou tyto podklady vyhodnocovat a vyjasňovat nejednoznačný význam zdroje.
Před rozšířením ověřte celý cyklus #
Proveďte jednu změnu zdroje celým cyklem: od odeslání přes načtení, ověření, kontrolu a doručení až po použití. Při bezpečné zkoušce změňte zdroj během zpracování a nasimulujte selhání jednoho cílového překladu. Ověřte, že lze stále určit aktuální revizi a že obnova zachová schválený výstup.
Pomocí zkušebního běhu workflow zaznamenejte, co skutečně proběhlo a co zatím nebylo otestováno. Návrh je připravený k rozšíření, když i někdo další z obsluhy dokáže vysvětlit, jak se překlad stane použitelným a jak obnovit předchozí použitelný stav.