Japans voor IT-ingenieurs: stand-ups, recensies en specificaties

Technische termen met hun Japanse waarden

Het grootste deel van de woordenschat in het vakgebied bestaat uit katakana, ontleend aan het Engels, wat goed nieuws is voor het lezen en slecht nieuws voor het luisteren. Server wordt sābā met twee lange klinkers en zonder r-geluid, data wordt dēta, release wordt rirīsu en samenvoeging wordt māji. Als u ze met Engelse klanken uitspreekt, kunnen collega's ze misschien niet zo snel opmerken en herkent u ze misschien niet als ze terugkomen. Leer elk woord als een Japans woord met zijn eigen lengte en ritme.

Naast elk leenwoord staat er meestal een kanji-woord dat voorkomt in tickets, specificaties en formele rapporten. Bagu is het chatwoord; fuguai is wat er in de titel van het ticket staat. Tesuto is wat je doet; kenshō is wat het rapport zegt dat je deed. Oudere documenten schrappen ook de laatste lange klinker van sommige leenwoorden, dus je zult sābā tegenkomen, geschreven als サーバ, en yūzā, geschreven als ユーザ. Het zijn dezelfde woorden.

De dagelijkse stand-up in drie delen

De ochtendbijeenkomst, vaak asakai of de dagelijkse bijeenkomst genoemd, volgt overal dezelfde drie vragen: wat je gisteren hebt gedaan, wat je vandaag gaat doen en of er iets is dat je blokkeert. Bereid drie zinnen voor, geen verhaal. Kinō wa voor gisteren, kyō wa voor vandaag, en ofwel burokkā wa toku ni arimasen of een specifieke plaats waar je vastzit. Gambarimasu zeggen in plaats van een concrete status is een veelgemaakte fout; de lead wil een taaknaam en een status.

Vooruitgangswoorden zijn belangrijk. Yotei dōri betekent op schema, sukoshi okurete imasu betekent iets achter, en kyō-jū ni owaru mikomi desu betekent dat je verwacht vandaag te finishen. Als je achterloopt, zeg dat dan in de stand-up in plaats van in een bericht de avond vóór de deadline; een Japans team vergeeft een vertraging waar het al vroeg van hoorde.

Een lead kan antwoorden met een korte follow-up, zoals itsu-goro owarisō desu ka, en ongeveer vragen wanneer het klaar zal zijn, of dare ka tetsudaimashō ka, door hulp aan te bieden. Antwoord met een dag en een taak, en schakel de hulp in als de blokkering buiten uw controle ligt.

Vragen naar een specificatie en uw begrip bevestigen

Specificatiegesprekken in Japan verlopen volgens het patroon iu rikai de atte imasu ka, wat betekent dat ik dat goed begrijp. Je herhaalt in je eigen woorden wat je denkt dat de specificatie zegt, en laat de ander dit bevestigen of corrigeren. Dit is geen teken van zwakte; de zinsnede ninshiki awase, begrip op één lijn brengen, is iets waar senior ingenieurs voortdurend om vragen. De fout is om vroegtijdig wakarimashita te zeggen om de discussie te beëindigen en vervolgens het verkeerde te bedenken.

Vraag waar een regel is geschreven met shiyōsho no doko ni kaite arimasu ka. Als het nergens geschreven staat, zal het antwoord vaak schouderophalen zijn, en dat is jouw signaal om het gedrag zelf voor te stellen en om instemming te vragen, waardoor het ook opgeschreven wordt.

Codereview-opmerkingen die direct maar beleefd zijn

Een goede Japanse recensie-commentaar benoemt het probleem duidelijk en verzacht alleen de instructie. Koko wa null ni naru kanōsei ga arimasu vermeldt het risico zonder dekking. De oplossing komt dan als een suggestie: shita hō ga ii kamo shiremasen, wat betekent dat het misschien beter is, of wakeraresō desu, wat betekent dat het lijkt alsof het kan worden gesplitst. Kleine stijlpunten zijn gemarkeerd met komakai desu ga, minor but, en een kale shite kudasai van een junior recensent leest als een bevel, dus bewaar het voor de toon van een lead of een duidelijke bug.

Bedank als auteur de recensent met go-shiteki arigatō gozaimasu en zeg wat je gaat doen. Als de code opzettelijk is, zeg dat dan met itoteki ni en geef de reden op; een Japanse recensent verwacht een reden, geen verdediging. De onderstaande uitwisseling toont beide zijden van één pull-verzoek.

Goedkeuring komt meestal binnen als LGTM desu of shōnin shimashita, en een samengevoegd pull-verzoek krijgt vaak een éénregelige māji shimashita in de thread. Reageer met arigatō gozaimasu, zelfs als de recensie ruw was; de draad wordt door het hele team gelezen.

Een bug en een incident melden

Een bugrapport in het Japans heeft hetzelfde skelet als waar dan ook: wat er is gebeurd, hoe je het kunt reproduceren, wat je had verwacht en wat je hebt gekregen. De woorden zijn saigen tejun voor reproductiestappen, kitai suru dōsa voor verwacht gedrag en jissai no dōsa voor feitelijk gedrag. Zeg rōkaru de wa saigen shimasen als het maar in één omgeving voorkomt; die zin scheelt een recensent een uur.

Voor een incident, shōgai, geldt een strengere volgorde. Het eerste rapport, daiippō, gaat snel uit en zegt alleen wat er kapot is en wie er getroffen is. De oorzaak komt later, na chōsa, onderzoek, en het slotrapport voegt saihatsu bōshi toe, preventie van herhaling. Japanse teams beoordelen je veel meer op de snelheid van het eerste bericht dan op de volledigheid ervan, dus verstuur het voordat je de oorzaak begrijpt.

Een deadline zachtjes inschatten en terugschuiven

Schattingen worden gegeven in dagen of in persoonsdagen, nin-nichi, en verzacht met hodo of kurai, wat ongeveer betekent. Mikka hodo desu is een normaal antwoord; een kaal getal zonder verzachter klinkt als een belofte, en beloften worden onthouden. Wanneer de gevraagde datum niet realistisch is, is het standaardwoord kibishii, strak, direct gevolgd door een alternatief. Het alternatief is wat de pushback acceptabel maakt: een latere datum, een kleinere reikwijdte of een vraag over prioriteiten die de lead laat kiezen.

Als je tijd nodig hebt om na te denken: ichido mochikaette kakunin shimasu, laat me het meenemen en controleren, is een gerespecteerde zin. Het geeft aan dat u de schatting serieus neemt in plaats van ter plekke te raden, en het levert u een dag op.

Een lead kan antwoorden met jā, getsuyōbi de onegai shimasu, maandag aanvaarden, of met nantoka narimasen ka, met de vraag of er iets gedaan kan worden. Voor de tweede keer: herhaal de scope-handel in plaats van te speleologie: als we deze functie laten vallen, is vrijdag mogelijk.

Een Japans kaartje lezen

Tickets zijn waar de kanji-vocabulaire leeft. De veldlabels worden op elke tracker herhaald, dus als je er twintig leert, verandert een onleesbare muur in een vorm die je kunt scannen. Statuswaarden zijn de waarden die je hardop uitspreekt tijdens de stand-up, dus lees ze met hun uitspraak, en niet alleen met hun betekenis.

Een ticket geschreven door een Japanse collega eindigt vaak met yoroshiku onegai shimasu, ook al is het maar een bugrapport, en jouw opmerking kan op dezelfde manier eindigen. Wanneer u een ticket sluit, wordt een éénregelige taiō shimashita afgehandeld, met een link naar het pull-verzoek, de verwachte aftekening.

Etiquette voor chattools

Teamchat in Japan is formeler dan de meeste ingenieurs verwachten. Een direct bericht wordt meestal geopend met otsukaresama desu, de universele begroeting op de werkplek, en een verzoek aan een druk persoon voegt o-tesuki no toki ni toe, als je even tijd hebt. Markeer de urgentie eerlijk: isogi de wa arimasen vertelt de lezer dat ze het kunnen laten staan ​​tot na de lunch, en shikyū betekent alles laten vallen, dus gebruik het zelden. Een emoji-reactie geldt voor de meeste teams als erkenning, maar een verzoek van een senior verdient een getypte shōchi shimashita.

Aanwezigheidsberichten zijn normaal in de Japanse chatcultuur. Riseki shimasu als je weggaat, modorimashita als je terugkomt, en honjitsu wa agarimasu als je je afmeldt voor de dag. Ze zien er eerst kieskeurig uit en worden binnen een week automatisch.

Een wekelijkse routine voor technisch Japans

• Zeg uw stand-up hardop vóór de vergadering, elke dag, met de echte ticketnamen; drie zinnen duren minder dan een minuut.
• Schrijf één beoordelingsopmerking per dag in het Japans, zelfs op een pull-verzoek van een collega dat u anders stilzwijgend zou goedkeuren, en gebruik elke keer één verzachtend formulier.
• Lees elke week één gesloten ticket van begin tot eind en spreek de statusgeschiedenis ervan uit: michakushu, taiō-chū, rebyū-machi, kanryō.
• Oefen eerst een incidentrapportage voor een systeem waarvan u de eigenaar bent, zodat de woorden op volgorde verschijnen wanneer het echte alarm afgaat.
• Oefen één deadlinegesprek per week waarin u een scope-transactie aanbiedt in plaats van een ja.
• Houd een lijst bij van leenwoorden die u tijdens vergaderingen verkeerd hebt uitgesproken en oefen de lange klinkers hardop.