Termini ingegneristici con le loro letture giapponesi
La maggior parte del vocabolario del campo è katakana preso in prestito dall'inglese, il che è una buona notizia per la lettura e una cattiva notizia per l'ascolto. Server diventa sābā con due vocali lunghe e il suono no r, data diventa dēta, release diventa rirīsu e merge diventa māji. Se le dici con suoni inglesi, i colleghi potrebbero non coglierle alla velocità della riunione e potresti non riconoscerle quando ritornano. Impara ciascuno come una parola giapponese con la propria lunghezza e ritmo.
Accanto ad ogni parola in prestito c'è solitamente una parola kanji che appare nei biglietti, nelle specifiche e nei rapporti formali. Bagu è la parola della chat; fuguai è ciò che va nel titolo del biglietto. Tesuto è quello che fai; kenshō è ciò che il rapporto dice che hai fatto. I documenti più vecchi eliminano anche la vocale lunga finale da alcuni prestiti linguistici, quindi incontrerai sābā scritto come サーバ e yūzā scritto come ユーザ. Sono le stesse parole.
| Termine | Romaji | Senso |
|---|---|---|
| バグ | bagù | bug (parola di tutti i giorni) |
| 不具合 | fuguai | difetto, la parola formale per un bug |
| サーバー | sābā | server |
| データ | dēta | dati |
| テスト | testo | test |
| リリース | ririsu | pubblicazione |
| デプロイ | depuroi | distribuire |
| マージ | maji | unire |
| プルリク | puru-riku | richiesta pull (forma breve) |
| レビュー | rebyū | revisione |
| ログ | rogu | tronco d'albero |
| エラー | era | errore |
| 仕様 | shiyo | specifica |
| 仕様書 | shiyosho | documento di specifica |
| ok | yōken | requisito |
| 設計 | sekkei | progetto |
| 実装 | jisso | implementazione |
| 改善 | Kaizen | miglioramento |
| 修正 | shūsei | aggiustare, correggere |
| 再現 | saigen | riproduzione di un bug |
| 検証 | kensho | verifica, testare una correzione |
| 本番 | honban | ambiente produttivo |
| 開発環境 | kaihatsu kankyo | ambiente di sviluppo |
| 障害 | shogai | incidente, interruzione |
| 影響範囲 | eikyō han'i | portata dell'impatto |
| 納期 | noki | termine di consegna |
| 工数 | kosū | sforzo, ore-persona |
| 見積もり | mitsumori | stima |
| 進捗 | shinchoku | progressi |
| 対応 | taio | maneggiare, trattare |
| 運用 | un'yō | operazioni |
| 保守 | hoshu | manutenzione |
| デグレ | degu | regressione, dal degrado |
| リスケ | rischio | riprogrammare |
| エビデンス | ebidensu | prove, solitamente uno screenshot che mostra un test superato |
Lo stand-up quotidiano in tre parti
L'incontro mattutino, spesso chiamato asakai o quotidiano, segue ovunque le stesse tre domande: cosa hai fatto ieri, cosa farai oggi e se qualcosa ti sta bloccando. Prepara tre frasi, non una storia. Kinō wa per ieri, kyō wa per oggi e burokkā wa toku ni arimasen o un luogo specifico in cui sei bloccato. Dire gambarimasu anziché uno status concreto è l'errore comune; il lead desidera un nome di attività e uno stato.
Le parole sul progresso contano. Yotei dōri significa nei tempi previsti, sukoshi okurete imasu significa leggermente indietro e kyō-jū ni owaru mikomi desu significa che ti aspetti di finire oggi. Se siete indietro, ditelo nello stand-up piuttosto che in un messaggio la sera prima della scadenza; una squadra giapponese perdona un ritardo di cui aveva sentito parlare presto.
| giapponese | Romaji | Senso |
|---|---|---|
| 昨日はログイン機能の実装を進めました。 | Kinō wa roguin kinō no jissō o susumemashita. | Ieri ho fatto progressi nell'implementazione della funzionalità di accesso. |
| 今日はテストを書いて、プルリクを出す予定です。 | Kyō wa tesuto o kaite, puru-riku o dasu yotei desu. | Oggi ho intenzione di scrivere test e aprire una richiesta pull. |
| ブロッカーは特にありません。 | Burokkā wa toku ni arimasen. | Nessun bloccante in particolare. |
| APIの仕様が決まっていないので、そこで止まっています。 | API no shiyō ga kimatte inai node, soko de tomatte imasu. | Le specifiche API non sono ancora state definite, quindi sono bloccato lì. |
| 進捗は予定どおりです。 | Shinchoku wa yotei dōri desu. | I progressi sono nei tempi previsti. |
| 少し遅れています。 | Sukoshi okurete imasu. | Sono un po' indietro. |
| 今日中に終わる見込みです。 | Kyō-jū ni owaru mikomi desu. | Mi aspetto di finire entro la fine di oggi. |
| 田中さんに確認したいことがあります。 | Tanaka-san ni kakunin shitai koto ga arimasu. | Ho qualcosa che voglio verificare con Tanaka. |
Un lead può rispondere con un breve seguito come itsu-goro owarisō desu ka, chiedendo all'incirca quando finirà, o dare ka tetsudaimashō ka, offrendo aiuto. Rispondi indicando un giorno e un'attività e accetta l'aiuto se il blocco è fuori dal tuo controllo.
Chiedere informazioni su una specifica e confermare la comprensione
Le conversazioni specifiche in Giappone seguono lo schema di iu rikai de atte imasu ka, il che significa che ho capito bene. Ribadi ciò che pensi che le specifiche dicano, con parole tue, e lasci che l'altra persona confermi o corregga. Questo non è un segno di debolezza; la frase ninshiki awase, allineare la comprensione, è qualcosa che gli ingegneri senior chiedono costantemente. L'errore è dire wakarimashita in anticipo per terminare la discussione e poi costruire la cosa sbagliata.
Chiedi dove è scritta una regola con shiyōsho no doko ni kaite arimasu ka. Se non è scritto da nessuna parte, la risposta sarà spesso un'alzata di spalle, e questo è il tuo spunto per proporre tu stesso il comportamento e chiedere un accordo, che lo mette anche per iscritto.
| giapponese | Romaji | Senso |
|---|---|---|
| この仕様について確認させてください。 | Kono shiyō ni tsuite kakunin sasete kudasai. | Vorrei confermare qualcosa su questa specifica. |
| エラーの場合は、画面にメッセージを出すという理解で合っていますか? | Erā no baai wa, gamen ni messēji o dasu to iu rikai de atte imasu ka? | Ho ragione nel dire che in caso di errore mostriamo un messaggio sullo schermo? |
| この場合はどう動くべきですか? | Kono baai wa dō ugoku beki desu ka? | Come dovrebbe comportarsi in questo caso? |
| 仕様書のどこに書いてありますか? | Shiyōsho no doko ni kaite arimasu ka? | Dov'è scritto questo nel documento delle specifiche? |
| 認識合わせをさせてください。 | Ninshiki awase o sasete kudasai. | Permettimi di assicurarmi che siamo sulla stessa lunghezza d'onda. |
| 要件を整理してもいいですか? | Yōken o seiri shite mo ii desu ka? | Posso riassumere i requisiti? |
| はい、その理解で合っています。 | Hai, sono rikai de atte imasu. | Sì, questa comprensione è corretta. |
| いえ、そこは少し違います。 | Ie, soko wa sukoshi chigaimasu. | No, quella parte è un po' diversa. |
| では、その内容でチケットに書いておきます。 | Dewa, sono naiyō de chiketto ni kaite okimasu. | Poi lo scriverò sul biglietto. |
Commenti di revisione del codice diretti ma educati
Un buon commento di recensione giapponese nomina chiaramente il problema e ammorbidisce solo le istruzioni. Koko wa null ni naru kanōsei ga arimasu indica il rischio senza copertura. La soluzione arriva quindi come suggerimento: Shita hō ga ii kamo shiremasen, che significa che potrebbe essere meglio, o wakeraresō desu, che significa che sembra che potrebbe essere diviso. Piccoli punti di stile sono contrassegnati con komakai desu ga, minore ma, e un nudo kudasai di merda da parte di un revisore junior si legge come un ordine, quindi conservalo per il tono di un lead o per un bug chiaro.
In qualità di autore, ringrazia il revisore con go-shiteki arigatō gozaimasu e dì cosa farai. Se il codice è intenzionale, dillo con itoteki ni e spiegane il motivo; un recensore giapponese si aspetta una ragione, non una difesa. Lo scambio seguente mostra entrambi i lati di una richiesta pull.
| giapponese | Romaji | Senso |
|---|---|---|
| お手すきの時にレビューをお願いします。 | O-tesuki no toki ni rebyū o onegai shimasu. | Per favore, rivedilo quando hai un momento. |
| ここはnullになる可能性があります。 | Koko wa null ni naru kanōsei ga arimasu. | Questo potrebbe diventare nullo qui. |
| 変数名をもう少し具体的にしたほうがいいかもしれません。 | Hensū-mei o mō sukoshi gutaiteki ni shita hō ga ii kamo shiremasen. | Potrebbe essere meglio rendere il nome della variabile un po' più specifico. |
| この処理は別の関数に分けられそうです。 | Kono shori wa betsu no kansū ni wakeraresō desu. | Sembra che questa logica possa essere suddivisa in una funzione separata. |
| 念のため、テストを追加してもらえますか? | Nen no tame, tesuto o tsuika shite moraemasu ka? | Per sicurezza potresti aggiungere un test? |
| 細かいですが、ここはタイポだと思います。 | Komakai desu ga, koko wa taipo da to omoimasu. | Minore, ma penso che questo sia un errore di battitura. |
| ご指摘ありがとうございます。修正します。 | Go-shiteki arigatō gozaimasu. Shūsei shimasu. | Grazie per averlo sottolineato. Lo aggiusterò. |
| ここは意図的にこうしています。理由は速度です。 | Koko wa itoteki ni kō shite imasu. Riyū wa sokudo desu. | Questo è intenzionale. Il motivo è la velocità. |
| 確認しました。問題ありません。 | Kakunin shimashita. Mondai arimasen. | Ho controllato. Nessun problema. |
L'approvazione di solito arriva come LGTM desu o shōnin shimashita e una richiesta pull unita spesso ottiene un māji shimashita di una riga nel thread. Rispondi con arigatō gozaimasu anche quando la recensione è stata dura; il thread viene letto da tutto il team.
Segnalazione di un bug e di un incidente
Una segnalazione di bug in giapponese ha lo stesso scheletro di qualsiasi altro posto: cosa è successo, come riprodurlo, cosa ti aspettavi e cosa hai ottenuto. Le parole sono saigen tejun per le fasi della riproduzione, kitai suru dōsa per il comportamento atteso e jissai no dōsa per il comportamento reale. Di' rōkaru de wa saigen shimasen quando appare solo in un ambiente; quella frase fa risparmiare un'ora a un revisore.
Un incidente, shōgai, ha un ordine più rigoroso. Il primo rapporto, daiippō, esce velocemente e dice solo cosa è rotto e chi è colpito. La causa viene dopo, dopo chōsa, indagine, e il rapporto conclusivo aggiunge saihatsu bōshi, prevenzione delle recidive. I team giapponesi ti giudicano molto più dalla velocità del primo messaggio che dalla sua completezza, quindi invialo prima di capirne la causa.
| giapponese | Romaji | Senso |
|---|---|---|
| 不具合を見つけました。 | Fuguai o mitsukemashita. | Ho trovato un difetto. |
| 本番でエラーが出ています。 | Honban de erā ga dete imasu. | Si stanno verificando errori nella produzione. |
| 影響範囲はログイン画面だけです。 | Eikyō han'i wa roguin gamen dake desu. | L'impatto è limitato alla schermata di accesso. |
| 再現手順は次のとおりです。 | Saigen tejun wa tsugi no tōri desu. | I passaggi per riprodurre sono i seguenti. |
| ローカルでは再現しません。 | Rōkaru de wa saigen shimasen. | Non si riproduce localmente. |
| 原因を調査中です。 | Gen'in o chōsa-chū desu. | Sto indagando sulla causa. |
| 一旦ロールバックしてもいいですか? | Ittan rōrubakku shite mo ii desu ka? | Posso tornare indietro per ora? |
| 復旧しました。 | Fukkyū shimashita. | È stato restaurato. |
| 原因は設定ミスでした。再発防止策を考えます。 | Gen'in wa settei misu deshita. Saihatsu bōshi-saku o kangaemasu. | La causa è stata un errore di configurazione. Capirò come prevenire il ripetersi. |
Stimare e posticipare dolcemente una scadenza
Le stime sono espresse in giorni o in giorni-persona, nin-nichi, e addolcite con hodo o kurai, che significa circa. Mikka hodo desu è una risposta normale; un semplice numero senza ammorbidente suona come una promessa e le promesse vengono ricordate. Quando la data richiesta non è realistica, la parola standard è kibishii, stretto, seguita immediatamente da un'alternativa. L’alternativa è ciò che rende accettabile il rifiuto: una data successiva, un ambito più ristretto o una domanda sulle priorità che consenta al lead di scegliere.
Se hai bisogno di tempo per pensare, ichido mochikaette kakunin shimasu, lasciamelo togliere e controlla, è una frase rispettata. Segnala che prendi sul serio la stima piuttosto che indovinare sul posto, e ti fa guadagnare una giornata.
| giapponese | Romaji | Senso |
|---|---|---|
| 見積もりは三日ほどです。 | Mitsumori wa mikka hodo desu. | La stima è di circa tre giorni. |
| 工数は二人日くらいかかりそうです。 | Kōsū wa ni-nin-nichi kurai kakarisō desu. | Probabilmente ci vorranno circa due giorni-persona. |
| 金曜日までは少し厳しいかもしれません。 | Kin'yōbi made wa sukoshi kibishii kamo shiremasen. | Venerdì potrebbe essere un po' stretto. |
| 来週の月曜日なら間に合います。 | Raishū no getsuyōbi nara ma ni aimasu. | Se è lunedì prossimo, posso farcela. |
| この機能を後回しにすれば、納期に間に合います。 | Kono kinō o atomawashi ni sureba, nōki ni ma ni aimasu. | Se rimandiamo questa funzione, possiamo rispettare la scadenza. |
| 優先順位を教えていただけますか? | Yūsen jun'i o oshiete itadakemasu ka? | Potresti dirmi l'ordine di priorità? |
| 一度持ち帰って確認します。 | Ichido mochikaette kakunin shimasu. | Lasciamelo togliere e controllo. |
Un indizio può rispondere con jā, getsuyōbi de onegai shimasu, accettando lunedì, o con nantoka narimasen ka, chiedendo se si può fare qualcosa. Al secondo, ripetere l'ambito commerciale anziché speleologico: kono kinō o hazuseba, kin'yōbi ni dekimasu, se tralasciamo questa caratteristica, il venerdì è possibile.
Leggere un biglietto giapponese
I biglietti sono il luogo in cui vive il vocabolario dei kanji. Le etichette dei campi si ripetono su ogni tracker, quindi apprenderne venti trasforma un muro illeggibile in un modulo che puoi scansionare. I valori di stato sono quelli che dirai ad alta voce nello stand-up, quindi leggili con la loro pronuncia, non solo con il loro significato.
| Campo biglietto | Romaji | Senso |
|---|---|---|
| 件名 | kenmei | titolo |
| 概要 | gaiyo | riepilogo |
| 再現手順 | Saigen Tejun | passaggi per riprodursi |
| 期待する動作 | kitai suru dosa | comportamento atteso |
| 実際の動作 | jissai no dosa | comportamento reale |
| 優先度 | yūsendo | priorità |
| 担当者 | tantosha | assegnatario |
| 期限 | kigen | scadenza |
| ステータス | sutetasu | stato |
| 未着手 | michakushu | non avviato |
| 対応中 | taiō-chū | in corso |
| レビュー待ち | rebyū-machi | in attesa di revisione |
| 保留 | horyū | in attesa |
| 要確認 | yō-kakunin | necessita di controllo |
| 対応済み | taio-zumi | gestito |
| 完了 | Kanryo | Fatto |
Un ticket scritto da un collega giapponese spesso termina con yoroshiku onegai shimasu anche quando si tratta solo di una segnalazione di bug, e il tuo commento può finire allo stesso modo. Quando chiudi un ticket, la firma prevista è un taiō shimashita di una riga, gestito, con un collegamento alla richiesta pull.
Etichetta dello strumento di chat
La chat di gruppo in Giappone è più formale di quanto la maggior parte degli ingegneri si aspetti. Un messaggio diretto di solito si apre con otsukaresama desu, il saluto multiuso sul posto di lavoro, e una richiesta a una persona impegnata aggiunge o-tesuki no toki ni, quando hai un momento. Segna l'urgenza onestamente: isogi de wa arimasen dice al lettore che può lasciarlo fino a dopo pranzo, e shikyū significa mollare tutto, quindi usalo raramente. Una reazione emoji conta come un riconoscimento nella maggior parte dei team, ma una richiesta da parte di qualcuno più anziano merita uno shōchi shimashita digitato.
I messaggi di presenza sono normali nella cultura della chat giapponese. Riseki shimasu quando ti allontani, modorimashita quando ritorni e honjitsu wa agarimasu quando concludi la giornata. All'inizio sembrano pignoli e diventano automatici entro una settimana.
| giapponese | Romaji | Senso |
|---|---|---|
| お疲れ様です。 | Otsukaresama desu. | Ciao (l'apertura standard della chat tra colleghi). |
| お手すきの時に見ていただけますか? | O-tesuki no toki ni mite itadakemasu ka? | Potresti dare un'occhiata quando hai un momento? |
| 急ぎではありません。 | Isogi de wa arimasen. | Non è urgente. |
| 至急確認をお願いします。 | Shikyū kakunin o onegai shimasu. | Per favore controllalo urgentemente. |
| 承知しました。 | Shōchi shimashita. | Inteso. |
| 確認して、後ほど返信します。 | Kakunin shite, nochihodo henshin shimasu. | Controllerò e risponderò più tardi. |
| 取り急ぎご報告まで。 | Toriisogi go-hōkoku made. | Solo un breve resoconto per ora. |
| 離席します。 | Riseki shimasu. | Mi allontano dalla mia scrivania. |
| 戻りました。 | Modorimashita. | Sono tornato. |
| 本日は上がります。お疲れ様でした。 | Honjitsu wa agarimasu. Otsukaresama deshita. | Chiudo per oggi. Grazie per il tuo lavoro |
Una routine settimanale per l'ingegneria giapponese
- Pronuncia la tua dichiarazione ad alta voce prima della riunione, ogni giorno, utilizzando i nomi reali dei biglietti; tre frasi richiedono meno di un minuto.
- Scrivi un commento di revisione in giapponese al giorno, anche sulla richiesta pull di un collega che altrimenti approveresti silenziosamente, e utilizza ogni volta un modulo attenuante.
- Leggi un biglietto chiuso dall'inizio alla fine ogni settimana e pronuncia la cronologia dello stato: michakushu, taiō-chū, rebyū-machi, kanryō.
- Prova il primo rapporto di un incidente per un sistema di tua proprietà, in modo che le parole vengano fuori in ordine quando viene attivato l'allarme vero e proprio.
- Esercitati in una conversazione sulla scadenza a settimana in cui offri uno scambio di ambito invece di un sì.
- Tieni un elenco dei prestiti che hai pronunciato male durante le riunioni e pronuncia ad alta voce le loro vocali lunghe.

