Kontrolní seznam spolehlivosti překladu pro Contentful

Překlad může být po jazykové stránce vynikající, a přesto může vydání selhat.

Mohl být použit nesprávný zdrojový snapshot. Struktura rich textu se mohla změnit. Zkontrolovaná hodnota se nemusela dostat do Contentful. Aktualizace může být přítomná, ale nepublikovaná. Spolehlivost vychází z ochrany celé cesty, ne z optimalizace jedné odpovědi modelu.

Před překladem

Začněte s jasně vymezenou hranicí zdroje.

• určete přesnou položku a prostředí v Contentful
• zaznamenejte zdrojové a cílové jazykové prostředí
• načítejte pouze pole způsobilá k překladu
• zachovejte odkazy, vložené objekty, značky a nepřekládatelnou strukturu
• zaznamenejte model, prompt a terminologická pravidla
• uveďte, zda jsou zahrnuta prázdná zdrojová pole

Pokud je rozsah požadavku před generováním nejednoznačný, každá další fáze tuto nejednoznačnost přebírá.

Během generování

Volání poskytovatele by mělo být pozorovatelné a dostatečně opakovatelné, aby podporovalo kontrolu.

Ověřte, že odpověď obsahuje každé očekávané pole a chráněný zástupný symbol. Odmítněte chybně vytvořený strukturovaný výstup místo toho, abyste se snažili zachránit části, které vypadají věrohodně.

Opakované pokusy by měly používat stejný rozsah požadavku. Pokud je vybrán jiný model nebo prompt, považujte výsledek za nový pokus, aby kontroloři mohli pochopit, proč se návrh změnil.

Během kontroly

Kontrola potřebuje tři stavy vedle sebe:

1. zdrojovou hodnotu použitou pro překlad
2. aktuální cílovou hodnotu v Contentful
3. navrhovaný lokalizovaný návrh

To odhaluje zastaralá zdrojová data a chrání stávající lokalizovanou práci.

U rich textu kontrolujte jazyk i hierarchii. Před schválením otevřete náhled CMS, pokud rozvržení, odkazy nebo vložený obsah ovlivňují stránku.

Úpravy provedené kontrolorem by se měly stát součástí historie uloženého návrhu, místo aby zmizely v závěrečném odeslání.

Během odeslání

Zapište co nejmenší možnou změnu.

Odesílejte pouze schválená pole cílového jazykového prostředí. Znovu načtěte aktuální položku z Contentful, zachovejte nesouvisející hodnoty a použijte nejnovější verzi položky. Pokud se stejné cílové pole změnilo po zahájení kontroly, zastavte se kvůli rozhodnutí místo automatického přepsání.

Zaznamenejte, která pole Contentful přijal a kdy. Úspěšná odpověď API by se měla promítnout do trvalého stavu požadavku dříve, než uživatelské rozhraní oznámí dokončení.

Během publikování

Odeslání a publikování jsou oddělené výsledky.

Potvrďte, že položka je způsobilá pro nakonfigurovaný režim publikování a že uživatel má oprávnění publikovat. Pokud je publikování automatické, udržujte jeho selhání oddělené od úspěchu překladu a odeslání.

Požadavek by měl jasně zobrazovat „odesláno, publikování selhalo“ namísto zhroucení celého workflow do obecného selhání.

Během obnovy

Spolehlivé systémy předpokládají, že poskytovatelé překročí časový limit, sítě se přeruší a verze CMS se dostanou do konfliktu.

• opakujte přechodné chyby v rámci omezených limitů
• pokračujte od fáze, ve které došlo k selhání
• zachovejte úspěšné překlady a odeslání beze změny
• zobrazte nejnovější chybu, na kterou lze reagovat
• umožněte zrušení tam, kde lze aktivní práci bezpečně zastavit
• zajistěte, aby konečný stav bylo možné obnovit pomocí dotazování i bez událostí v reálném čase

Obnova by měla práci zachovat, ne ji reflexivně restartovat.

Shrnutí

Pro překlad v Contentful neexistuje jediná funkce spolehlivosti.

Důvěra vychází z úzce zaměřených pojistek na každé hranici: explicitní rozsah, chráněná struktura, porovnatelné stavy kontroly, minimální zápisy, oddělený stav publikování a obnova podle fáze. Když tyto kontroly fungují společně, týmy se mohou pohybovat rychle, aniž by s každým vícejazyčným vydáním zacházely jako s hazardem.