Tjekliste for pålidelig oversættelse i Contentful

En oversættelse kan være sprogligt fremragende og stadig fejle ved udgivelsen.

Det forkerte kilde-snapshot kan være blevet brugt. Rich-text-strukturen kan være ændret. En gennemgået værdi kan være ikke nået frem til Contentful. Opdateringen kan være til stede, men ikke publiceret. Pålidelighed kommer af at beskytte hele forløbet, ikke af at optimere ét modelsvar.

Før oversættelse

Start med en tydelig kildeafgrænsning.

• identificer den præcise Contentful-post og det præcise miljø
• registrer kilde- og mållokalerne
• indlæs kun felter, der er kvalificerede til oversættelse
• bevar links, indlejringer, markeringer og ikke-oversættelig struktur
• registrer model, prompt og terminologiregler
• vis, om tomme kildefelter er inkluderet

Hvis omfanget af anmodningen er tvetydigt før generering, arver hver senere fase den tvetydighed.

Under generering

Provider-kaldet bør være observerbart og tilstrækkeligt gentageligt til at understøtte gennemgang.

Valider, at svaret indeholder hvert forventet felt og hver beskyttet pladsholder. Afvis fejlformet struktureret output i stedet for at forsøge at gemme de dele, der ser plausible ud.

Retries bør genbruge det samme anmodningsomfang. Hvis en anden model eller prompt vælges, så behandl resultatet som et nyt forsøg, så reviewere kan forstå, hvorfor udkastet ændrede sig.

Under gennemgang

Gennemgang kræver tre tilstande side om side:

1. kildeværdien, der blev brugt til oversættelse
2. den aktuelle målværdi i Contentful
3. det foreslåede lokaliserede udkast

Dette afslører forældede kildedata og beskytter eksisterende lokaliseret arbejde.

For rich text skal både sprog og hierarki gennemgås. Åbn CMS-forhåndsvisningen før godkendelse, når layout, links eller indlejret indhold påvirker siden.

Redigeringer foretaget af revieweren bør blive en del af den gemte udkasthistorik i stedet for at forsvinde i et endeligt push.

Under push

Skriv den mindst mulige ændring.

Push kun godkendte felter for mållokalet. Hent den aktuelle Contentful-post igen, bevar ikke-relaterede værdier, og brug den nyeste postversion. Hvis det samme målfelt ændrede sig, efter at gennemgangen begyndte, så stop for en beslutning i stedet for automatisk at overskrive det.

Registrer, hvilke felter Contentful accepterede, og hvornår. Et vellykket API-svar bør knyttes til varig anmodningstilstand, før UI'et annoncerer fuldførelse.

Under publicering

Push og publicering er separate resultater.

Bekræft, at posten er kvalificeret til den konfigurerede publiceringstilstand, og at brugeren har tilladelse til at publicere. Hvis publicering er automatisk, skal dens fejl holdes uafhængig af succes med oversættelse og push.

Anmodningen bør tydeligt vise "pushed, publish failed" i stedet for at sammenfatte hele workflowet til en generisk fejl.

Under gendannelse

Pålidelige systemer antager, at providere får timeout, netværk bliver afbrudt, og CMS-versioner kommer i konflikt.

• forsøg igen ved midlertidige fejl inden for afgrænsede grænser
• genoptag fra den fejlede fase
• bevar vellykkede oversættelser og pushes intakte
• vis den seneste handlingsrelevante fejl
• tillad annullering, hvor aktivt arbejde kan stoppes sikkert
• gør endelig tilstand gendannelig gennem polling selv uden realtime-hændelser

Gendannelse bør bevare arbejdet, ikke refleksmæssigt genstarte det.

Konklusion

Der findes ikke én enkelt pålidelighedsfunktion til oversættelse i Contentful.

Tillid kommer fra snævre sikkerhedsforanstaltninger ved hver grænse: eksplicit omfang, beskyttet struktur, sammenlignelige gennemgangstilstande, minimale skrivninger, separat publiceringstilstand og fasebevidst gendannelse. Når disse kontroller arbejder sammen, kan teams bevæge sig hurtigt uden at behandle hver flersproget udgivelse som et sats.