Arbeidsflyt for gjennomgang

Med arbeidsflyten for gjennomgang har teamet kontroll over hva som publiseres når det er ekstra viktig at et menneske har lest alle tekstene. Teammedlemmer ser og justerer oversettelser i Localhero.ai-dashbordet uten å skrive kode, bruke git eller opprette en sak. Endringene sendes tilbake til den opprinnelige pull requesten i en commit.

Du kan også velge hvilke språk Localhero.ai skal oversette til automatisk. For språkene du velger bort, kan du fylle inn oversettelsene selv i det samme grensesnittet.

Hele løpet på 45 sekunder: en pull request legger til ny tekst, sjekken venter, en reviewer godkjenner, sjekken blir grønn.

Gå gjennom AI-oversettelser

Slik fungerer det for den som skal gå gjennom oversettelsene i en pull request:

1. En utvikler åpner en pull request som legger til eller endrer oversettelsesnøkler i språkfilene. GitHub-actionen oversetter nye eller manglende nøkler og legger resultatet inn i pull requesten som en commit. Deretter skriver den en kommentar i pull requesten med lenke til Localhero.ai.
2. Alle med tilgang til prosjektet kan legge til én eller flere personer som skal gå gjennom oversettelsene. Hver av dem får en e-post med en lenke der de kan se oversettelsene og justere dem ved behov. Når Slack er koblet til, kan du også spørre en kanal; den som åpner lenken fra Slack, blir lagt til som gjennomgåer. En administrator kobler til Slack under Integrasjoner i organisasjonsinnstillingene og deretter velger hvert prosjekt kanalene sine i prosjektinnstillingene. Der kan du også få hver nye pull request med oversettelser postet i en kanal.
3. Du ser oversettelsene i stedet for en kodediff og retter det som trengs. Endringene lagres i Localhero.ai. Hver rettelse går også inn i prosjektets oversettelsesminne, som senere oversettelser følger.
4. Når du er ferdig, godkjenner du pull requesten og legger eventuelt ved en kommentar. På PR-siden i Localhero.ai ser du hvor mange som har godkjent pull requesten. Når alle har godkjent, vises "Klar til å merge", og en kommentar om det postes på pull requesten i GitHub.
5. Hvis noen oversettelser er endret, klikker du på Synk til GitHub på PR-siden i Localhero.ai. Endringene sendes tilbake til pull requesten som en commit, så alt er med når den merges.

Skjermbilder i pull requesten

En tekst er lettere å gå gjennom når du ser hvor den vises. Legg skjermbilder i beskrivelsen av pull requesten på GitHub som vanlig, eller slipp dem på PR-siden i Localhero.ai. Localhero.ai leser teksten i hvert skjermbilde og matcher den mot tekstene i pull requesten. På PR-siden lenker hver tekst til skjermbildet den står i, med teksten markert. Skjermbilder fra beskrivelsen krever at GitHub-appen er installert.

Skjermbildene lagres i Frankfurt (EU). Localhero.ai leser teksten på egne servere der og sender ikke skjermbildene til AI-modeller. De slettes når noen fjerner dem, på PR-siden eller fra beskrivelsen, eller 90 dager etter at pull requesten er merget eller lukket.

Løpet på litt over ett minutt: en pull request med skjermbilder i beskrivelsen, GitHub-actionen committer oversettelsene, en reviewer får beskjed i Slack, ser hver tekst markert i skjermbildet og godkjenner, sjekken localhero/translations blir grønn.

Oversettelseskontrollen på pull requesten

Oversettelser kan styre merge-knappen på PR-en, på samme måte som en test som feiler kan hindre at en PR kan merges. Når en gjennomgåer har godkjent, rapporterer Localhero.ai en commit-status som heter localhero/translations på pull requesten, ved siden av deres egne CI-kontroller, med teksten Translations approved on Localhero. Statusen lenker til PR-siden, så den som leser pull requesten kan gå rett til oversettelsene.

Hvis du gjør den til en obligatorisk statuskontroll, blir det et vilkår for å kunne merge pull requests: Settings → Branches → Branch protection rules, rediger regelen for standardbranchen, huk av for Require status checks to pass before merging og søk opp localhero/translations. Kontrollen må ha kjørt minst én gang i repoet før GitHub viser den i listen, så godkjenn først oversettelser på en pull request.

Da kan ikke en pull request med tildelte gjennomgåere merges før oversettelsene er godkjent. Ingen prosess å huske, ingen leting på releasedagen etter om den norske teksten faktisk ble lest. Lar du kontrollen stå utenfor branch protection, er den informativ, en grønn hake som viser at oversettelsene er gjennomgått.

Synkkontrollen på pull requesten

En endring i Localhero.ai blir bare med når den er i branchen. En andre commit-status, localhero/sync, viser om den er det. Localhero.ai rapporterer den på hver pull request i et tilkoblet repo:

• Venter så lenge det finnes endringer i Localhero.ai som ikke er i pull requesten ennå, og mens en synking er på vei.
• Feilet når den siste synkingen ikke ble ferdig. PR-siden viser hvorfor og tilbyr Prøv igjen.
• Godkjent når alle endringene er i branchen, eller når det ikke finnes noen.

Kontrollen er valgfri. Gjør du den obligatorisk, kan ikke en pull request merges mens endringer fortsatt venter i Localhero.ai. Legg den til på samme måte som localhero/translations: synk først én endring til en pull request, så GitHub har sett kontrollen, og legg deretter til localhero/sync blant de obligatoriske statuskontrollene.

GitHub-apper som ble installert før kontrollen fantes, trenger én tillatelse til, Commit statuses: Read and write, før Localhero.ai kan rapportere localhero/sync. GitHub ber eieren av kontoen eller organisasjonen om å godta den via e-post. Så lenge den mangler, viser prosjektets generelle innstillinger i Localhero.ai et varsel med en lenke til riktig side på GitHub.

Står en pull request fast på kontrollen, åpner du den i Localhero.ai og klikker på Hold utenfor denne PR-en. Kontrollen blir godkjent, og endringene blir liggende i Localhero.ai. Synk likevel sender dem likevel, og hver nye endring gjør kontrollen ventende igjen.

Tre begrensninger:

• Hvis Localhero.ai er nede, får nye commits ingen localhero/sync-status før tjenesten er oppe igjen. En obligatorisk kontroll venter da. Når Localhero.ai er oppe igjen, tar statusen seg inn i løpet av omtrent 10 minutter.
• Fjern den obligatoriske kontrollen før du avinstallerer GitHub-appen. Uten appen rapporterer ingen localhero/sync, og en obligatorisk kontroll som aldri rapporteres, blokkerer alle pull requests.
• Merge queues støttes ikke. Localhero.ai rapporterer på pull requestens siste commit, ikke på merge queue-commits, så ikke gjør localhero/sync eller localhero/translations obligatorisk på en branch som bruker merge queue.

En godkjenning hører sammen med nøyaktig de oversettelsene den ble gitt for. Endrer du en tekst etter at noen har godkjent, merker Localhero.ai godkjenningen som utdatert på PR-siden og tilbyr Godkjenn på nytt. En godkjenning betyr at noen har lest denne teksten, ikke en tekst som siden har endret seg.

Du kan også redigere oversettelser direkte på oversettelsessiden uten å gå via en pull request. Merk oversettelsesnøklene du har endret, og klikk på Eksporter til GitHub øverst til høyre. Localhero.ai åpner da en pull request med endringene.

Begge funksjonene krever at GitHub-appen er installert. Appen har skrivetilgang til repoet ditt. Uten den kan du fortsatt gå gjennom og redigere oversettelser i dashbordet, men du kan ikke sende endringene tilbake til GitHub. Hent da oversettelsene lokalt med CLI-et i stedet.

Legg til personer som skal gå gjennom oversettelsene

Tilgang til prosjektet i Localhero.ai er alt som trengs. Inviter dem via fanen Medlemmer i organisasjonsinnstillingene. De trenger verken git eller en kodeeditor.

Utviklerne beholder arbeidsflyten de allerede bruker. Språkfilene i repoet er fortsatt fasiten. Oversettelsesnøklene legges til der, og oversettelsene kommer som commits i pull requesten. Verken utviklere eller de som går gjennom oversettelsene trenger å bytte verktøy.

Oversette enkelte språk selv

For hvert målspråk i prosjektinnstillingene kan du slå av Automatisk oversettelse. Slår du den av for et språk, lager Localhero.ai ingen oversettelser for det. GitHub-actionen og CLI-et genererer da ingen oversettelser for språket. Nøklene og språket blir liggende i dashbordet, der din egen oversetter kan fylle inn oversettelsene.

Dette er nyttig når teksten skrives direkte på målspråket, når ulike markeder har ulike behov, ved juridisk sensitive formuleringer eller for språkvarianter med egne krav.

Les videre: GitHub-appen om hva appen kan skrive til repoet ditt og oversettelseskvalitet i stor skala om hvordan du sikrer konsekvente oversettelser når antallet oversettelsesnøkler vokser.