Granskningsflöde

Med granskningsflödet har teamet kontroll över vad som går live när det är extra viktigt att alla texter granskats av en människa. Teammedlemmar ser och justerar översättningar i Localhero.ai-dashboarden utan att skriva kod, använda git eller skapa ett ärende. Ändringarna skickas tillbaka till den ursprungliga pull requesten i en commit.

Du kan också välja vilka språk som ska AI-översättas automatiskt, och fylla i översättningarna manuellt i samma gränssnitt för de språk du valt bort.

Hela flödet på 45 sekunder: en pull request lägger till ny text, kontrollen väntar, en granskare godkänner, kontrollen blir grön.

Granska AI-översättningar

Så här fungerar flödet för den som granskar en pull request:

1. En utvecklare öppnar en pull request som lägger till eller ändrar översättningsnycklar i språkfilerna. GitHub-actionen översätter de nycklar som är nya eller saknas och lägger resultatet i pull requesten som en commit. En kommentar postas på pull requesten med en länk till Localhero.ai.
2. Alla med tillgång till projektet kan lägga till en eller flera granskare. Varje tillagd granskare får ett mejl med en länk för att se översättningarna och justera dem efter behov. Med Slack kopplat kan du också fråga en kanal; den som öppnar länken från Slack blir granskare. En administratör kopplar Slack under Integrationer i organisationens inställningar och sedan väljer varje projekt sina kanaler i projektets inställningar. Där kan du också låta varje ny pull request med översättningar postas i en kanal.
3. Granskaren ser översättningarna i stället för en koddiff och rättar det som behövs. Ändringarna sparas i Localhero.ai. Varje rättning går också in i projektets översättningsminne, som senare översättningar följer.
4. När granskaren är klar godkänner hen pull requesten och kan lämna en kommentar. PR-sidan på Localhero.ai visar hur många granskare som har godkänt den och visar "Klar för merge" när alla är klara. När samtliga granskare godkänt postas en kommentar om det på pull requesten i GitHub.
5. Om någon översättning har ändrats klickar du eller granskaren på Synka till GitHub på PR-sidan i Localhero.ai. Då skickas ändringarna tillbaka som en commit till pull requesten, så allt är med vid merge.

Skärmbilder på pull requesten

En text är lättare att granska när man ser var den syns. Lägg skärmbilder i pull requestens beskrivning på GitHub som vanligt, eller släpp dem på PR-sidan i Localhero.ai. Localhero.ai läser texten i varje skärmbild och matchar den mot texterna i pull requesten. På PR-sidan länkar varje text till skärmbilden där den syns, med texten markerad. Skärmbilder från beskrivningen kräver att GitHub-appen är installerad.

Skärmbilderna lagras i Frankfurt (EU). Localhero.ai läser texten på egna servrar där och skickar inte skärmbilderna till AI-modeller. De raderas när någon tar bort dem, på PR-sidan eller ur beskrivningen, eller 90 dagar efter att pull requesten mergats eller stängts.

Flödet på drygt en minut: en pull request med skärmbilder i beskrivningen, GitHub-actionen committar översättningarna, en granskare får en fråga i Slack, ser varje text markerad i sin skärmbild och godkänner, kontrollen localhero/translations blir grön.

Översättningskontrollen på pull requesten

Översättningar kan styra merge-knappen på PR:en, precis som ett test som inte går igenom kan hindra att en PR går att merga. När en granskare godkänt rapporterar Localhero.ai en commit-status som heter localhero/translations på pull requesten, bredvid era egna CI-kontroller, med texten Translations approved on Localhero. Statusen länkar till PR-sidan, så den som läser pull requesten kan gå direkt till översättningarna.

Om du gör den till en obligatorisk statuskontroll blir det ett villkor för att kunna merga pull requests: Settings → Branches → Branch protection rules, redigera regeln för din standardbranch, kryssa i Require status checks to pass before merging och sök upp localhero/translations. Kontrollen måste ha körts minst en gång i repot innan GitHub visar den i listan, så godkänn först översättningar på en pull request.

Då går det inte att merga en pull request med tillagda granskare förrän översättningarna är godkända. Ingen process att komma ihåg, inget letande på releasedagen efter om den norska texten någonsin blev läst. Lämnar du kontrollen utanför branch protection är den informativ, en grön bock som visar att översättningarna är granskade.

Synkkontrollen på pull requesten

En ändring i Localhero.ai följer bara med när den finns i branchen. En andra commit-status, localhero/sync, visar om den gör det. Localhero.ai rapporterar den på varje pull request i ett kopplat repo:

• Väntar så länge det finns ändringar i Localhero.ai som inte finns i pull requesten än, och medan en synk är på väg.
• Misslyckad när den senaste synken inte blev klar. PR-sidan visar varför och erbjuder Försök igen.
• Godkänd när alla ändringar finns i branchen, eller när det inte finns några.

Kontrollen är frivillig. Gör du den obligatorisk går det inte att merga en pull request medan ändringar fortfarande väntar i Localhero.ai. Lägg till den på samma sätt som localhero/translations: synka först en ändring till en pull request så att GitHub har sett kontrollen, och lägg sedan till localhero/sync bland de obligatoriska statuskontrollerna.

GitHub-appar som installerades innan kontrollen fanns behöver ytterligare en behörighet, Commit statuses: Read and write, innan Localhero.ai kan rapportera localhero/sync. GitHub ber ägaren av kontot eller organisationen att godkänna den via mejl. Så länge den saknas visar projektets allmänna inställningar i Localhero.ai en notis med en länk till rätt sida på GitHub.

Fastnar en pull request på kontrollen, öppna den i Localhero.ai och klicka på Lämna utanför den här PR:en. Kontrollen blir godkänd och ändringarna finns kvar i Localhero.ai. Synka ändå skickar dem ändå, och varje ny ändring gör kontrollen väntande igen.

Tre begränsningar:

• Om Localhero.ai ligger nere får nya commits ingen localhero/sync-status förrän tjänsten är uppe igen. En obligatorisk kontroll väntar då. När Localhero.ai är uppe igen kommer statusen ikapp inom ungefär 10 minuter.
• Ta bort den obligatoriska kontrollen innan du avinstallerar GitHub-appen. Utan appen rapporterar ingen localhero/sync, och en obligatorisk kontroll som aldrig rapporteras blockerar alla pull requests.
• Merge queues stöds inte. Localhero.ai rapporterar på pull requestens senaste commit, inte på merge queue-commits, så gör inte localhero/sync eller localhero/translations obligatoriska på en branch som använder merge queue.

Ett godkännande hör ihop med exakt de översättningar det gavs för. Ändrar du en text efter att någon godkänt märker Localhero.ai godkännandet som inaktuellt på PR-sidan och erbjuder Godkänn igen. Ett godkännande betyder att någon har läst den här texten, inte en text som hunnit ändras sedan dess.

Du kan också redigera översättningar direkt på översättningssidan utan att utgå från en pull request. Markera de översättningsnycklar du har ändrat och klicka på Exportera till GitHub uppe till höger. Localhero.ai öppnar då en pull request med ändringarna.

Båda funktionerna kräver att GitHub-appen är installerad, eftersom den har behörighet att skriva till ditt repo. Utan appen kan du fortfarande granska och redigera i dashboarden, men du kan inte skicka ändringarna tillbaka till GitHub. Hämta då översättningarna lokalt med CLI:t i stället.

Lägga till granskare

Tillgång till projektet i Localhero.ai är allt en granskare behöver. Bjud in dem via fliken Medlemmar i organisationsinställningarna. De behöver varken ha git installerat eller en kodredigerare.

Utvecklarna behåller sitt vanliga flöde. Det är fortfarande språkfilerna i repot som gäller. Översättningsnycklarna läggs till där, och översättningarna läggs till som commits i pull requesten. Varken utvecklare eller granskare behöver byta verktyg.

Översätta vissa språk själv

För varje målspråk i projektinställningarna kan du slå av Automatisk översättning. Stänger du av den för ett språk skapar Localhero.ai inga översättningar för det. GitHub-actionen och CLI:t hoppar då över att generera översättningar för språket. Nycklarna och språket finns fortfarande kvar i dashboarden, där din egen översättare kan fylla i översättningarna.

Användbart när text ska skrivas direkt på målspråket i stället för att översättas, när du har särskilda behov på olika marknader, vid juridiskt känsliga formuleringar eller för en variant med särskilda krav.

Läs vidare: GitHub-appen om vad appen kan skriva till ditt repo, och översättningskvalitet i stor skala om hur du får konsekventa översättningar när antalet översättningsnycklar växer.