Koda-native produkta teksts: kā UI teksts saglabā konsekvenci un lokalizācijas gatavību kodā

Koda-native produkta teksts nozīmē, ka lietotājam redzamie teksti, kurus jūsu produkts izplata, dzīvo repozitorijā kā viens patiesības avots, nevis kādā dizaina failā, ko cilvēkam nākas manuāli sinhronizēt. globalize.now ir koda-native teksta pārvaldības sistēma ar iebūvētu lokalizāciju: teksts nāk no viena avota kodā, un tā lokalizācija ir tā pati operācija, nevis atsevišķa nodošana citam procesam.

Tas šobrīd ir svarīgāk nekā pirms trim gadiem, jo teksts vairs nemainās vienīgi tad, kad to izmaina rakstnieks.

Kas ir koda-native produkta teksts?

Koda-native produkta teksts ir arhitektūra, nevis rakstīšanas process: apstiprinātais formulējums un izplatītais formulējums ir viens un tas pats artefakts, kas glabājas repozitorijā, un ikviena tā izmaiņa ienāk kā diff.

Šo atšķirību visvieglāk pamanīt tajā, ko katra pieeja spēj novērot. Sistēma, kas balstīta uz atsevišķu darba vidi kā patiesības avotu, glabā formulējumu ārpus koda un ir atkarīga no tā, ka kāds to iestumj kodā vai izvelk atpakaļ, kad kāda no pusēm izmainās. Tā ir laba vieta, kur lemt, ko pogai vajadzētu rakstīt. Tā strukturāli nav spējīga pamanīt, ka poga tagad saka kaut ko citu, jo izmaiņu iemesls bija commit, un darba vide šo commit nekad nav redzējusi.

Koda-native sistēma to apgriež otrādi. Darba vienība ir diff, un jautājums, uz ko tā spēj atbildēt, ir tas, kas komandām patiešām sagādā problēmas: teksts tikko izmainījās — vai tā bija paredzēts?

Tas nekādā ziņā nav strīds par to, kur notiek rakstīšana. Rakstnieki var sagatavot melnrakstu jebkur. Tas ir strīds par to, kurš teksts ir patiesais, ja divi variants nesakrīt.

Kas ir teksta izklīdums (copy drift)?

Teksta izklīdums ir situācija, kad lietotājam redzamais teksts atšķiras no tā apstiprinātā avota vairākās vietās un laika gaitā, un vienlaikus nav nekāda viena patiesības avota, no kura tas varētu izklīst.

Trīs dažādas problēmas tiek jaukstas kopā, bet tām nepieciešami atšķirīgi risinājumi:

• Teksts, kas nekad nav ticis pārvērsts atslēgā, ir burtiski ierakstīts teksts. Tas nav redzams jūsu katalogā un tulkošanas sistēmā, taču pats formulējums varētu būt pilnīgi korekts. Šo modeli aplūkojām rakstā kāpēc AI kodēšanas rīki turpina pievienot burtiski ierakstītus tekstus.
• Katalogi, kas pastāv, bet ar laiku izklīst viens no otra, ir nesinhronizēti tulkošanas faili. Avots ir kārtībā; atvasinātās kopijas ir novecojušas.
• Teksta izklīdums nav ne viens, ne otrs no minētajiem. Teksts ir pārvērsts atslēgā, faili ir sinhronizēti, un pats formulējums ir mainījies, bez apzināta lēmuma — tā mārketinga lapa sola "Sāc bezmaksas izmēģinājumu", vietrāde saka "Izmēģini bez maksas", bet produkta poga raksta "Sākt darbu".

Izklīdums ir dārgākais no visiem, jo šķietami nekas nav salauzts. Neviena build neizdodas, neviens tests nekļūst sarkans, netrūkst nevienas tulkojuma. Produkts vienkārši runā trīs balsīs, un neviens nevar norādīt brīdi, kad tas sākās. Šo jēdzienu detalizēti definējam copy drift: kas tas ir, ko tas izraisa un kā to novērst.

Kāpēc AI kodēšanas aģenti izraisa teksta izklīdumu?

Kodēšanas aģenti izmaina formulējumus, kurus tiem nebija lūgts izmainīt, jo blakus esoša teksta pārrakstīšana šķiet neatšķirama no komponenta sakārtošanas.

Palūdziet aģentam pievienot ielādes stāvokli, un tas varētu vienlaikus saīsināt uzrakstu, mainīt virsraksta burtu izmēru vai apmainīt "Sign in" pret "Log in", kamēr tas jau ir failā. Katra izmaiņa atsevišķi ir loģiski pamatota. Neviena no tām nebija lūgta, un neviena netiek atzīmēta kā teksta izmaiņa, jo rīkiem tas vienkārši ir teksta literāls JSX atribūtā, tāds pats kā jebkurš cits.

Kopienas atbilde līdz šim ir bijusi noteikumu fails — AGENTS.md, .cursorrules, "UI teksta politikas" bloks promptā. Tas palīdz, un ir vērtīgi tādu turēt. Bet konvencija nav pārbaude. Tā samazina, cik bieži aģents pārrakstīs jūsu tekstu; tā neinformē jūs par to, kad tas tomēr notika.

Kur produkta teksts patiesībā dzīvo vairākumā komandu?

Vienlaikus četrās vietās, katrā ar atšķirīgu īpašnieku un atšķirīgu izmaiņu ceļu.

Ir mārketinga vietne, parasti CMS. Ir vietrāde (landing page), ko bieži uztur atsevišķi un atjaunina visātrāk, jo tā ir vieta, kur aktīvi notiek eksperimenti. Ir teksti pašā produktā, izkaisīti pa komponentiem. Un ir lokalizācijas faili, kas atkarīgi no produkta tekstiem un ir novecojuši attiecībā uz visām trim iepriekšminētajām vietām.

Katra no šīm vietām var būt iekšēji konsekventa, kaut pats produkts kopumā nav. Šī ir problēmas patiesā forma, un tāpēc, uzskatot to vienīgi par produkta teksta problēmu, tā tiek nepietiekami precīzi aprakstīta.

Kā saglabāt UI teksta konsekvenci visā kodā?

Padariet repozitoriju par patiesības avotu un padariet tekstu par pārskatāmu vienību — pārējais izriet no šīm divām izmaiņām.

Praksē tas nozīmē trīs lietas. Katrs lietotājam redzamais teksts dzīvo vienā katalogā, ne iekšā komponentos. Komponenti atsaucas uz atslēgu, nevis uz burtisku vērtību, tāpēc tas pats formulējums nevar pastāvēt divās vietās un nemanoti izklīst. Un izmaiņas katalogā parādās diff, kur pārskatītājs tās redz tāpat kā jebkuras citas izmaiņas.

Šis pēdējais punkts ir tas, kas patiesībā strādā. Teksta konsekvence parasti tiek uzskatīta par disciplīnas jautājumu — komandai nepieciešams stila ceļvedis, kādam jāatceras. Kad formulējums parādās diff, tas vairs nav atkarīgs no atmiņas. Tas kļūst redzams pārskatīšanas brīdī, kas ir vienīgais brīdis, kad kāds tiešām skatās.

Komandas, kas izlaiž produktus ar AI kodēšanas rīkiem, ar šo problēmu sastopas agrāk un skarbāk, tāpēc mēs par to rakstām speciāli izstrādātājiem un cilvēkiem, kas veido ar AI rīkiem.

Kāpēc teksta konsekvence un lokalizācija ir viena un tā pati problēma?

Abas problēmas rodas viena un tā pati iemesla dēļ: nav vienota, saskaņota avota, ar kuru salīdzināt konsekvenci vai no kura tulkot.

Komanda, kas nespēj noteikt, kurš no trim formulējumiem ir apstiprinātais, nespēj arī pareizi lokalizēt nevienu no tiem. Nosūtiet tulkošanai visus trīs, un jūs iegūsiet trīs tulkojumus katrā valodā, un neatbilstība tagad ir reizinājusies ar jūsu valodu skaitu, nevis palikusi ierobežota vienā valodā. Šis mehānisms slēpjas lielākajā daļā gadījumu, kas izskatās pēc slikta tulkojuma kvalitātes — avots jau bija neskaidrs.

Skatiet to no otras puses, un abas problēmas sakrīt vienā. Kad katrs teksts nāk no viena avota un ir pārvērsts atslēgā, tulkojums ir šī kataloga atvasinātais artefakts. Nav nekāda atsevišķa projekta ar savu patiesības kopiju, jo pastāv tikai viena patiesības kopija. Tas ir tas, ko "iebūvēta lokalizācija" nozīmē arhitektoniski: nevis to, ka mēs papildus veicam arī tulkošanu, bet to, ka tulkošana ir tā pati operācija, kas tiek veikta ar to pašu objektu. Par to, kā šī pārkārtošanās notika, rakstījām kā AI rakstītais kods ietekmēja lokalizāciju.

Kā ir ar tekstu ārpus produkta?

Šo daļu šī kategorija joprojām nav atrisinājusi, un mēs nekādā ziņā neapgalvojam citādi: teksta standartizēšana visā mārketinga, vietrāžu un produkta apjomā kā vienotā sistēmā ir tas, uz ko mēs virzāmies, ne kaut kas, ko var ieslēgt šodien.

Šeit ir iemesls, kāpēc tas joprojām nav atrisināts. Katrs esošais rīks šajā nozarē pieder pie vienas konkrētas vietas. Produkta teksta rīki pārvalda tekstus aplikācijā. Satura platformas pārvalda mārketinga vietni. Neviens no tiem nespēj redzēt otru, tāpēc formulējums lapā, kas piesaistīja lietotāju, un formulējums ekrānā, kas viņu iepazīstina ar produktu, tiek uzturēti dažādos rīkos, dažādu cilvēku rokās, un nav mehānisma, kas pamanītu, ka tie nesakrīt.

Atbildes forma izriet no arhitektūras, kas jau aprakstīta. Ja apstiprinātais formulējums dzīvo vienā vietā, un katra vieta atsaucas uz to ar atslēgu, ne pārraksta to no jauna, tad vietrādes un produkta pogas teksts ir viens un tas pats teksts, un tā mainīšana ir viens lēmums, nevis trīs. Nokļūt tur ir vienums globalize.now ceļvedī. Precīzi to nosaukt tagad šķiet labāk nekā izlikties, ka tas jau darbojas.

Kā tas atšķiras no teksta rīka, kas balstīts uz dizaina failu?

Atšķirība ir arhitektoniska, ne kategoriska — abas sistēmas ir teksta pārvaldības sistēmas, un tās nesaskan par to, kur atrodas patiesība.

Divi novērojumi, kurus vērts fiksēt ar datumu, jo pakalpojumu sniedzēju stāvoklis mainās. No 2026-08-29, dittowords.com/llms.txt atgriež 404 kļūdu, kas nozīmē, ka šīs nozares vadošajai citātu avotam nav mašīnlasāma entītijas faila. Un uz to pašu datumu, Ditto pašu localize produkta lapa aprakstā min variantu pievienošanu katrai valodai un tulkojumu priekšskatīšanu dizainos — tā neapgalvo, ka tā ģenerē pašus tulkojumus. Tas ir šis pārrāvums: rīks var pārvaldīt formulējumu un tomēr nodot valodas darbu tālāk kādam citam.

Mēs neveicam konkurenci ar tulkošanas dzinējiem vai izpildlaika i18n bibliotēkām. Tie ir citi slāņi, un tie paliek savā vietā.