Tekniska termer med sina japanska läsningar
Det mesta av fältets ordförråd är katakana lånat från engelska, vilket är goda nyheter för läsning och dåliga nyheter för att lyssna. Servern blir sābā med två långa vokaler och inget r-ljud, data blir dēta, release blir rirīsu och merge blir māji. Om du säger dem med engelska ljud kanske kollegor inte fångar dem i möteshastighet, och du kanske inte känner igen dem när de kommer tillbaka. Lär dig vart och ett som ett japanskt ord med sin egen längd och rytm.
Bredvid varje lånord finns det vanligtvis ett kanji-ord som förekommer i biljetter, specifikationer och formella rapporter. Bagu är chattordet; fuguai är vad som står i biljetttiteln. Tesuto är vad du gör; kenshō är vad rapporten säger att du gjorde. Äldre dokument tar också bort den sista långa vokalen från vissa lånord, så du kommer att möta sābā skrivet som サーバ och yūzā skrivet som ユーザ. Det är samma ord.
| Kalla | Romaji | Menande |
|---|---|---|
| バグ | bagu | bugg (vardagsord) |
| 不具合 | fuguai | defekt, det formella ordet för en bugg |
| サーバー | sābā | server |
| データ | dēta | data |
| テスト | tesuto | testa |
| リリース | rirīsu | släppa |
| デプロイ | depuroi | distribuera |
| マージ | māji | slå ihop |
| プルリク | puru-riku | pull begäran (kort form) |
| レビュー | rebyū | recension |
| ログ | rogu | logga |
| エラー | era | fel |
| 仕様 | shiyō | specifikation |
| 仕様書 | shiyōsho | specifikationsdokument |
| 要件 | yōken | krav |
| 設計 | sekkei | design |
| 実装 | jissō | genomförande |
| 改善 | kaizen | förbättring |
| 修正 | shūsei | fixa, korrigera |
| 再現 | saigen | reproduktion av en bugg |
| 検証 | kenshō | verifiering, testning av en fix |
| 本番 | honban | produktionsmiljö |
| 開発環境 | kaihatsu kankyō | utvecklingsmiljö |
| 障害 | shōgai | incident, avbrott |
| 影響範囲 | eikyō han'i | påverkans omfattning |
| 納期 | nōki | leveranstid |
| 工数 | kōsū | ansträngning, persontimmar |
| 見積もり | mitsumori | uppskatta |
| 進捗 | shinchoku | framsteg |
| 対応 | taiō | hantera, hantera |
| 運用 | un'yō | operationer |
| 保守 | hoshu | underhåll |
| デグレ | deure | regression, från degradera |
| リスケ | risuke | schemalägga om |
| エビデンス | ebidensu | bevis, vanligtvis en skärmdump som visar ett godkänt test |
Den dagliga standupen i tre delar
Morgonmötet, ofta kallat asakai eller det dagliga, följer samma tre frågor överallt: vad du gjorde igår, vad du kommer att göra idag och om något blockerar dig. Förbered tre meningar, inte en berättelse. Kinō wa för igår, kyō wa för idag, och antingen burokkā wa toku ni arimasen eller en specifik plats där du har fastnat. Att säga gambarimasu istället för en konkret status är det vanliga misstaget; ledaren vill ha ett uppgiftsnamn och ett tillstånd.
Framstegsord spelar roll. Yotei dōri betyder på schemat, sukoshi okurete imasu betyder något efter, och kyō-jū ni owaru mikomi desu betyder att du förväntar dig att avsluta idag. Om du ligger efter, säg det i stand-up snarare än i ett meddelande kvällen innan deadline; ett japanskt lag förlåter en försening det hörde talas om tidigt.
| japanska | Romaji | Menande |
|---|---|---|
| 昨日はログイン機能の実装を進めました。 | Kinō wa roguin kinō no jissō o susumemashita. | Igår gjorde jag framsteg med att implementera inloggningsfunktionen. |
| 今日はテストを書いて、プルリクを出す予定です。 | Kyō wa tesuto o kaite, puru-riku o dasu yotei desu. | Idag planerar jag att skriva tester och öppna en pull request. |
| ブロッカーは特にありません。 | Burokkā wa toku ni arimasen. | Inga blockerare i synnerhet. |
| APIの仕様が決まっていないので、そこで止まっています。 | API no shiyō ga kimatte inai node, soko de tomatte imasu. | API-specifikationen är inte klar än, så jag har fastnat där. |
| 進捗は予定どおりです。 | Shinchoku wa yotei dōri desu. | Framstegen följer schemat. |
| 少し遅れています。 | Sukoshi okurete imasu. | Jag ligger lite efter. |
| 今日中に終わる見込みです。 | Kyō-jū ni owaru mikomi desu. | Jag räknar med att bli klar i slutet av idag. |
| 田中さんに確認したいことがあります。 | Tanaka-san ni kakunin shitai koto ga arimasu. | Jag har något jag vill kolla med Tanaka. |
En lead kan svara med en kort uppföljning som itsu-goro owarisō desu ka, fråga ungefär när det kommer att sluta, eller våga ka tetsudaimashō ka, erbjuda hjälp. Svara med en dag och en uppgift, och ta hjälp om blockeraren är utanför din kontroll.
Frågar om en spec och bekräftar din förståelse
Specifikationssamtal i Japan körs på mönstret att iu rikai de atte imasu ka, vilket betyder är min förståelse korrekt att. Du upprepar vad du tror att specen säger, med dina egna ord, och låter den andra personen bekräfta eller rätta. Detta är inte ett tecken på svaghet; frasen ninshiki awase, att anpassa förståelsen, är något seniora ingenjörer ständigt efterfrågar. Felet är att säga wakarimashita tidigt för att avsluta diskussionen och sedan bygga fel sak.
Fråga var en regel är skriven med shiyōsho no doko ni kaite arimasu ka. Om det inte står skrivet någonstans blir svaret ofta en axelryckning, och det är din signal att själv föreslå beteendet och be om överenskommelse, vilket också får det nedskrivet.
| japanska | Romaji | Menande |
|---|---|---|
| この仕様について確認させてください。 | Kono shiyō ni tsuite kakunin sasete kudasai. | Låt mig bekräfta något om denna spec. |
| エラーの場合は、画面にメッセージを出すという理解で合っていますか？ | Erā no baai wa, gamen ni messēji o dasu to iu rikai de atte imasu ka? | Har jag rätt i att vi vid fel visar ett meddelande på skärmen? |
| この場合はどう動くべきですか？ | Kono baai wa dō ugoku beki desu ka? | Hur ska det bete sig i det här fallet? |
| 仕様書のどこに書いてありますか？ | Shiyōsho no doko ni kaite arimasu ka? | Var står det skrivet i specifikationsdokumentet? |
| 認識合わせをさせてください。 | Ninshiki awase o sasete kudasai. | Låt mig se till att vi är på samma sida. |
| 要件を整理してもいいですか？ | Yōken o seiri shite mo ii desu ka? | Får jag sammanfatta kraven? |
| はい、その理解で合っています。 | Hai, sono rikai de atte imasu. | Ja, den förståelsen är korrekt. |
| いえ、そこは少し違います。 | Ie, soko wa sukoshi chigaimasu. | Nej, den delen är lite annorlunda. |
| では、その内容でチケットに書いておきます。 | Dewa, sono naiyō de chiketto ni kaite okimasu. | Då skriver jag det i biljetten. |
Kodgranskningskommentarer som är direkta men artiga
En bra japansk recensionskommentar namnger problemet tydligt och mjukar bara upp instruktionen. Koko wa null ni naru kanōsei ga arimasu anger risken utan säkring. Fixeringen kommer sedan som ett förslag: shita hō ga ii kamo shiremasen, vilket betyder att det kan vara bättre att, eller wakeraresō desu, vilket betyder att det ser ut att kunna delas. Små stilpunkter är markerade med komakai desu ga, moll men, och en kal shite kudasai från en junior recensent läses som en order, så spara den för en leads ton eller en tydlig bugg.
Som författare, tacka recensenten med go-shiteki arigatō gozaimasu och säg vad du kommer att göra. Om koden är avsiktlig, säg det med itoteki ni och ange anledningen; en japansk recensent förväntar sig en anledning, inte ett försvar. Utbytet nedan visar båda sidor av en pull-begäran.
| japanska | Romaji | Menande |
|---|---|---|
| お手すきの時にレビューをお願いします。 | O-tesuki no toki ni rebyū o onegai shimasu. | Vänligen granska detta när du har en stund. |
| ここはnullになる可能性があります。 | Koko wa null ni naru kanōsei ga arimasu. | Detta kan bli ogiltig här. |
| 変数名をもう少し具体的にしたほうがいいかもしれません。 | Hensū-mei o mō sukoshi gutaiteki ni shita hō ga ii kamo shiremasen. | Det kan vara bättre att göra variabelnamnet lite mer specifikt. |
| この処理は別の関数に分けられそうです。 | Kono shori wa betsu no kansū ni wakeraresō desu. | Denna logik ser ut att kunna delas upp i en separat funktion. |
| 念のため、テストを追加してもらえますか？ | Nen no tame, tesuto o tsuika shite moraemasu ka? | Bara för säkerhets skull, kan du lägga till ett test? |
| 細かいですが、ここはタイポだと思います。 | Komakai desu ga, koko wa taipo da to omoimasu. | Mindre, men jag tror att detta är ett stavfel. |
| ご指摘ありがとうございます。修正します。 | Go-shiteki arigatō gozaimasu. Shūsei shimasu. | Tack för att du påpekade det. Jag ska fixa det. |
| ここは意図的にこうしています。理由は速度です。 | Koko wa itoteki ni kō shite imasu. Riyū wa sokudo desu. | Detta är avsiktligt. Anledningen är hastigheten. |
| 確認しました。問題ありません。 | Kakunin shimashita. Mondai arimasen. | Jag kollade. inga problem. |
Godkännande kommer vanligtvis som LGTM desu eller shōnin shimashita, och en sammanslagen pull-begäran får ofta en enrads māji shimashita i tråden. Svara med arigatō gozaimasu även när recensionen var grov; tråden läses av hela laget.
Rapportera en bugg och en incident
En felrapport på japanska har samma skelett som någon annanstans: vad som hände, hur man återskapar det, vad du förväntade dig och vad du fick. Orden är saigen tejun för reproduktionssteg, kitai suru dōsa för förväntat beteende och jissai no dōsa för faktiskt beteende. Säg rōkaru de wa saigen shimasen när det bara dyker upp i en miljö; den meningen sparar en recensent en timme.
En incident, shōgai, har en strängare ordning. Den första rapporten, daiippō, går snabbt ut och säger bara vad som är trasigt och vem som är drabbad. Orsaken kommer senare, efter chōsa, undersökning, och den avslutande rapporten lägger till saihatsu bōshi, förhindrande av återfall. Japanska lag bedömer dig mycket mer på hastigheten på det första meddelandet än på dess fullständighet, så skicka det innan du förstår orsaken.
| japanska | Romaji | Menande |
|---|---|---|
| 不具合を見つけました。 | Fuguai o mitsukemashita. | Jag hittade en defekt. |
| 本番でエラーが出ています。 | Honban de erā ga dete imasu. | Det uppstår fel i produktionen. |
| 影響範囲はログイン画面だけです。 | Eikyō han'i wa roguin gamen dake desu. | Effekten är begränsad till inloggningsskärmen. |
| 再現手順は次のとおりです。 | Saigen tejun wa tsugi no tōri desu. | Stegen för att reproducera är som följer. |
| ローカルでは再現しません。 | Rōkaru de wa saigen shimasen. | Den förökar sig inte lokalt. |
| 原因を調査中です。 | Gen'in o chōsa-chū desu. | Jag undersöker orsaken. |
| 一旦ロールバックしてもいいですか？ | Ittan rōrubakku shite mo ii desu ka? | Får jag rulla tillbaka för nu? |
| 復旧しました。 | Fukkyū shimashita. | Den har återställts. |
| 原因は設定ミスでした。再発防止策を考えます。 | Gen'in wa settei misu deshita. Saihatsu bōshi-saku o kangaemasu. | Orsaken var ett konfigurationsfel. Jag kommer att ta reda på hur man förhindrar en upprepning. |
Uppskattar och trycker tillbaka på en deadline mjukt
Uppskattningar ges i dagar eller i persondagar, nin-nichi, och mjukas upp med hodo eller kurai, vilket betyder ungefär. Mikka hodo desu är ett normalt svar; ett bart nummer utan mjukgörare låter som ett löfte, och löften kommer ihåg. När det begärda datumet inte är realistiskt är standardordet kibishii, tight, följt omedelbart av ett alternativ. Alternativet är det som gör pushbacken acceptabel: ett senare datum, en mindre omfattning eller en fråga om prioriteringar som låter ledningen välja.
Om du behöver tid att tänka, är ichido mochikaette kakunin shimasu, låt mig ta bort det och kolla, en respekterad mening. Det signalerar att du tar uppskattningen på allvar snarare än att gissa på plats, och det köper dig en dag.
| japanska | Romaji | Menande |
|---|---|---|
| 見積もりは三日ほどです。 | Mitsumori wa mikka hodo desu. | Uppskattningen är cirka tre dagar. |
| 工数は二人日くらいかかりそうです。 | Kōsū wa ni-nin-nichi kurai kakarisō desu. | Det kommer förmodligen att ta ungefär två arbetsdagar. |
| 金曜日までは少し厳しいかもしれません。 | Kin'yōbi made wa sukoshi kibishii kamo shiremasen. | Fredagen kan bli lite trång. |
| 来週の月曜日なら間に合います。 | Raishū no getsuyōbi nara ma ni aimasu. | Om det är nästa måndag så klarar jag det. |
| この機能を後回しにすれば、納期に間に合います。 | Kono kinō o atomawashi ni sureba, nōki ni ma ni aimasu. | Om vi skjuter upp detta inslag kan vi hålla tidsfristen. |
| 優先順位を教えていただけますか？ | Yūsen jun'i o oshiete itadakemasu ka? | Kan du berätta för mig prioritetsordningen? |
| 一度持ち帰って確認します。 | Ichido mochikaette kakunin shimasu. | Låt mig ta bort det och kolla. |
En lead kan svara med jā, getsuyōbi de onegai shimasu, acceptera måndag, eller med nantoka narimasen ka och fråga om något kan göras. Till det andra, upprepa scope-handeln istället för att gräva: kono kinō o hazuseba, kin'yōbi ni dekimasu, om vi släpper den här funktionen är fredag möjlig.
Läser en japansk biljett
Biljetter är där kanji-ordförrådet bor. Fältetiketterna upprepas över alla spårare, så att lära sig tjugo av dem förvandlar en oläsbar vägg till en form som du kan skanna. Statusvärden är de du kommer att säga högt i stand-up, så läs dem med deras uttal, inte bara deras betydelse.
| Biljettfält | Romaji | Menande |
|---|---|---|
| 件名 | kenmei | titel |
| 概要 | gaiyō | sammanfattning |
| 再現手順 | saigen tejun | steg för att reproducera |
| 期待する動作 | kitai suru dōsa | förväntat beteende |
| 実際の動作 | jissai no dōsa | faktiskt beteende |
| 優先度 | yūsendo | prioritet |
| 担当者 | tantōsha | uppdragstagaren |
| 期限 | kigen | förfallodatum |
| ステータス | sutētasu | status |
| 未着手 | michakushu | inte startat |
| 対応中 | taiō-chū | pågår |
| レビュー待ち | rebyū-machi | väntar på granskning |
| 保留 | horyū | på is |
| 要確認 | yō-kakunin | behöver kontrolleras |
| 対応済み | taiō-zumi | hanteras |
| 完了 | kanryō | gjort |
En biljett skriven av en japansk kollega slutar ofta med yoroshiku onegai shimasu även när det bara är en felrapport, och din kommentar kan sluta på samma sätt. När du stänger en biljett, är en enrads taiō shimashita, hanterad, med en länk till pull-begäran den förväntade sign-off.
Etikett för chattverktyg
Teamchatt i Japan är mer formell än de flesta ingenjörer förväntar sig. Ett direktmeddelande öppnas vanligtvis med otsukaresama desu, den allsidiga hälsningen på arbetsplatsen, och en förfrågan till en upptagen person lägger till o-tesuki no toki ni, när du har en stund. Markera brådskande ärligt: isogi de wa arimasen säger till läsaren att de kan lämna det till efter lunch, och shikyū betyder släpp allt, så använd det sällan. En emoji-reaktion räknas som en bekräftelse på de flesta lag, men en begäran från någon senior förtjänar en maskinskriven shōchi shimashita.
Närvaromeddelanden är normala i japansk chattkultur. Riseki shimasu när du kliver bort, modorimashita när du kommer tillbaka och honjitsu wa agarimasu när du anmäler dig för dagen. De ser noga ut till en början och blir automatiska inom en vecka.
| japanska | Romaji | Menande |
|---|---|---|
| お疲れ様です。 | Otsukaresama desu. | Hej (standard chattöppnare mellan kollegor). |
| お手すきの時に見ていただけますか？ | O-tesuki no toki ni mite itadakemasu ka? | Kan du ta en titt när du har en stund? |
| 急ぎではありません。 | Isogi de wa arimasen. | Det är inte brådskande. |
| 至急確認をお願いします。 | Shikyū kakunin o onegai shimasu. | Kontrollera detta snarast. |
| 承知しました。 | Shōchi shimashita. | Förstått. |
| 確認して、後ほど返信します。 | Kakunin shite, nochihodo henshin shimasu. | Jag kollar och svarar senare. |
| 取り急ぎご報告まで。 | Toriisogi go-hōkoku made. | Bara en snabb rapport nu. |
| 離席します。 | Riseki shimasu. | Går bort från mitt skrivbord. |
| 戻りました。 | Modorimashita. | Jag är tillbaka. |
| 本日は上がります。お疲れ様でした。 | Honjitsu wa agarimasu. Otsukaresama deshita. | Skriver av för idag. Tack för ditt arbete. |
En veckovis rutin för att konstruera japanska
- Säg din stand-up högt före mötet, varje dag, med hjälp av de riktiga biljettnamnen; tre meningar tar under en minut.
- Skriv en recensionskommentar på japanska per dag, även på en kollegas pull-begäran som du annars skulle godkänna tyst, och använd ett mjukgörande formulär varje gång.
- Läs en stängd biljett från början till slut varje vecka och berätta dess statushistorik: michakushu, taiō-chū, rebyū-machi, kanryō.
- Repetera en incidentrapport för ett system du äger, så att orden kommer ut i ordning när den riktiga varningen avfyras.
- Öva ett deadline-samtal i veckan där du erbjuder en scope trade istället för ett ja.
- Håll en lista över lånord du uttalade fel på möten och borra upp deras långa vokaler.