Kako smo izgradili i automatizirali japansku GitLab dokumentaciju

Kako smo izgradili i automatizirali novu japansku GitLab dokumentaciju

U GitLabu uvijek težimo poboljšanju korisničkog iskustva, bez obzira na jezik ili regiju. U nedavnoj inicijativi, naš je tim izgradio i automatizirao novu japansku verziju GitLab dokumentacije – zadatak koji je zahtijevao tehnološku stručnost, lokalizacijsko znanje i visoku razinu suradnje između timova.

Glavni izazov bio je uspostaviti skalabilan i održiv proces za prevođenje dokumentacije bez dupliciranja sadržaja ili narušavanja toka rada glavnog repozitorija. Koristili smo GitLabov CI/CD mehanizam i vanjski alat za lokalizaciju kako bismo postigli potpunu automatizaciju – od dohvaćanja najnovijih prijevoda, do njihovog integriranja u statički site generiran s MkDocs-om.

Za sinkronizaciju sadržaja koristili smo GitLabov API, a proces konverzije iz izvornog GitLab Markdowna u kompatibilni MkDocs format riješen je prilagođenim skriptama. Ovo nam je omogućilo održavanje konzistentnosti u strukturi i povezivanju sadržaja, uz dodatak lokaliziranih elemenata kao što su navigacija i kodni primjeri prilagođeni japanskom jeziku.

Automatsko objavljivanje obavljeno je uz pomoć GitLab Pages, a sve promjene prevoditeljskog sadržaja prate se kroz Merge Requestove, čime se osigurava kvaliteta i transparentnost procesa.

Ova inicijativa nije samo povećala dostupnost GitLab alata japanskoj zajednici, već je poslužila i kao temelj za buduće lokalizacije na druge jezike.

Ako želite implementirati sličan proces lokalizacije ili automatizacije dokumentacije za svoj tim ili organizaciju, IDEA GitLab Solutions nudi profesionalne konzultantske usluge i licenciranje u Hrvatskoj, Sloveniji, Srbiji, Crnoj Gori, Sjevernoj Makedoniji, Velikoj Britaniji i ostalim zemljama koje podržavamo.

• Unaprijedite Git tokove rada uz GitLab | IDEA GitLab Solutions
• Migracija s Azure DevOps na GitLab - Unificirani pristup DevSecOps-u
• Automatizirajte usklađenost ugradbenih sustava uz GitLab i CodeSonar
• Neprekidna isporuka najveće GitLab instance
• Sigurno postavljanje AI agenta na Google Kubernetes Engine uz GitLab