Termeni de inginerie cu lecturile lor japoneze
Majoritatea vocabularului din domeniu este katakana împrumutat din engleză, ceea ce este o veste bună pentru citit și vești proaste pentru ascultare. Serverul devine sābā cu două vocale lungi și fără sunet r, datele devin dēta, release devine rirīsu și merge devine māji. Dacă le spui cu sunete englezești, este posibil ca colegii să nu-i prindă cu viteza întâlnirii și s-ar putea să nu-i recunoști că se întorc. Învață fiecare ca un cuvânt japonez cu propria lungime și ritm.
Pe lângă fiecare cuvânt de împrumut există de obicei un cuvânt kanji care apare în bilete, specificații și rapoarte oficiale. Bagu este cuvântul de discuție; fuguai este ceea ce se înscrie în titlul biletului. Tesuto este ceea ce faci; kenshō este ceea ce raportul spune că ai făcut. Documentele mai vechi elimină și vocala lungă finală din unele cuvinte împrumutate, așa că veți întâlni sābā scris ca サーバ și yūzā scris ca ユーザ. Sunt aceleași cuvinte.
| Termen | Romaji | Sens |
|---|---|---|
| バグ | bagu | bug (cuvânt de zi cu zi) |
| 不具合 | fuguai | defect, cuvântul formal pentru un bug |
| サーバー | sābā | server |
| データ | dēta | date |
| テスト | tesuto | test |
| リリース | rirīsu | eliberare |
| デプロイ | depuroi | disloca |
| マージ | māji | îmbina |
| プルリク | puru-riku | cerere de tragere (forma scurtă) |
| レビュー | rebyū | recenzie |
| ログ | rogu | jurnal |
| エラー | eră | eroare |
| 仕様 | shiyō | caietul de sarcini |
| 仕様書 | shiyōsho | caietul de sarcini |
| 要件 | yōken | cerinţă |
| 設計 | sekkei | proiecta |
| 実装 | jissō | implementare |
| 改善 | kaizen | îmbunătăţire |
| 修正 | shūsei | reparare, corectare |
| 再現 | saigen | reproducerea unui bug |
| 検証 | kenshō | verificare, testare a unei remedieri |
| 本番 | honban | mediu de producție |
| 開発環境 | kaihatsu kankyō | mediu de dezvoltare |
| 障害 | shōgai | incident, întrerupere |
| 影響範囲 | eikyō han'i | domeniul de impact |
| 納期 | nōki | termen de livrare |
| 工数 | kōsū | efort, ore persoană |
| 見積もり | mitsumori | estima |
| 進捗 | shinchoku | progres |
| 対応 | taiō | manipulare, tratare cu |
| 運用 | un'yō | operațiuni |
| 保守 | hoshu | întreţinere |
| デグレ | degura | regresie, de la degradare |
| リスケ | riscuke | reprogramați |
| エビデンス | ebidensu | dovezi, de obicei o captură de ecran care arată un test trecut |
Stand-up-ul zilnic în trei părți
Întâlnirea de dimineață, numită adesea asakai sau cotidianul, urmează peste tot aceleași trei întrebări: ce ai făcut ieri, ce vei face astăzi și dacă ceva te blochează. Pregătește trei propoziții, nu o poveste. Kinō wa pentru ieri, kyō wa pentru azi și fie burokkā wa toku ni arimasen, fie un anumit loc în care ești blocat. A spune gambarimasu în locul unui statut concret este greșeala comună; liderul vrea un nume de sarcină și o stare.
Cuvintele de progres contează. Yotei dōri înseamnă conform programului, sukoshi okurete imasu înseamnă puțin în urmă, iar kyō-jū ni owaru mikomi desu înseamnă că te aștepți să termini astăzi. Dacă sunteți în urmă, spuneți acest lucru în stand-up și nu într-un mesaj cu o seară înainte de termenul limită; o echipă japoneză iartă o întârziere despre care a auzit devreme.
| japonez | Romaji | Sens |
|---|---|---|
| 昨日はログイン機能の実装を進めました。 | Kinō wa roguin kinō no jissō o susumemashita. | Ieri am făcut progrese în implementarea funcției de conectare. |
| 今日はテストを書いて、プルリクを出す予定です。 | Kyō wa tesuto o kaite, puru-riku o dasu yotei desu. | Astăzi intenționez să scriu teste și să deschid un pull request. |
| ブロッカーは特にありません。 | Burokkā wa toku ni arimasen. | Fără blocanți în special. |
| APIの仕様が決まっていないので、そこで止まっています。 | API no shiyō ga kimatte inai node, soko de tomatte imasu. | Specificația API nu este încă stabilită, așa că sunt blocat acolo. |
| 進捗は予定どおりです。 | Shinchoku wa yotei dōri desu. | Progresul este conform programului. |
| 少し遅れています。 | Sukoshi okurete imasu. | sunt putin in urma. |
| 今日中に終わる見込みです。 | Kyō-jū ni owaru mikomi desu. | Mă aștept să termin până la sfârșitul zilei de azi. |
| 田中さんに確認したいことがあります。 | Tanaka-san ni kakunin shitai koto ga arimasu. | Am ceva ce vreau să verific cu Tanaka. |
Un client potențial poate răspunde cu o scurtă urmărire, cum ar fi itsu-goro owarisō desu ka, întrebând aproximativ când se va termina, sau dare ka tetsudaimashō ka, oferind ajutor. Răspundeți cu o zi și o sarcină și luați ajutor dacă blocantul este în afara controlului dumneavoastră.
Întrebând despre o specificație și confirmând înțelegerea dvs
Conversațiile despre specificații din Japonia se desfășoară pe modelul iu rikai de atte imasu ka, ceea ce înseamnă că înțelegerea mea este corectă. Repești ceea ce crezi că spune specificația, cu propriile tale cuvinte, și lași pe cealaltă persoană să confirme sau să corecteze. Acesta nu este un semn de slăbiciune; expresia ninshiki awase, alinierea înțelegerii, este ceva ce inginerii seniori îl cer în mod constant. Greșeala este să spui wakarimashita devreme pentru a încheia discuția și apoi a construi lucrul greșit.
Întrebați unde este scrisă o regulă cu shiyōsho no doko ni kaite arimasu ka. Dacă nu este scris nicăieri, răspunsul va fi adesea o ridicare din umeri, iar acesta este indiciul tău pentru a-ți propune singur comportamentul și a cere acordul, care, de asemenea, îl notează.
| japonez | Romaji | Sens |
|---|---|---|
| この仕様について確認させてください。 | Kono shiyō ni tsuite kakunin sasete kudasai. | Să confirm ceva despre această specificație. |
| エラーの場合は、画面にメッセージを出すという理解で合っていますか？ | Erā no baai wa, gamen ni messēji o dasu to iu rikai de atte imasu ka? | Am dreptate că în caz de eroare afișăm un mesaj pe ecran? |
| この場合はどう動くべきですか？ | Kono baai wa dō ugoku beki desu ka? | Cum ar trebui să se comporte în acest caz? |
| 仕様書のどこに書いてありますか？ | Shiyōsho no doko ni kaite arimasu ka? | Unde este scris asta în documentul cu specificații? |
| 認識合わせをさせてください。 | Ninshiki awase o sasete kudasai. | Să mă asigur că suntem pe aceeași pagină. |
| 要件を整理してもいいですか？ | Yōken o seiri shite mo ii desu ka? | Pot rezuma cerințele? |
| はい、その理解で合っています。 | Hai, sono rikai de atte imasu. | Da, acea înțelegere este corectă. |
| いえ、そこは少し違います。 | Ie, soko wa sukoshi chigaimasu. | Nu, acea parte este puțin diferită. |
| では、その内容でチケットに書いておきます。 | Dewa, sono naiyō de chiketto ni kaite okimasu. | Apoi voi scrie asta în bilet. |
Comentarii de revizuire a codului care sunt directe, dar politicoase
Un comentariu bun de recenzie japoneză numește problema clar și înmoaie doar instrucțiunile. Koko wa null ni naru kanōsei ga arimasu afirmă riscul fără acoperire. Remedierea vine apoi ca o sugestie: shita hō ga ii kamo shiremasen, adică ar putea fi mai bine, sau wakeraresō desu, ceea ce înseamnă că se pare că ar putea fi împărțit. Punctele de stil mici sunt marcate cu komakai desu ga, minor dar, și un kudasai shite gol de la un recenzent junior se citește ca o comandă, așa că păstrează-l pentru tonul unui lead sau un bug clar.
În calitate de autor, mulțumiți recenzentului cu go-shiteki arigatō gozaimasu și spuneți ce veți face. Dacă codul este intenționat, spuneți așa cu itoteki ni și dați motivul; un recenzent japonez se așteaptă la un motiv, nu la o apărare. Schimbul de mai jos arată ambele părți ale unei cereri de tragere.
| japonez | Romaji | Sens |
|---|---|---|
| お手すきの時にレビューをお願いします。 | O-tesuki no toki ni rebyū o onegai shimasu. | Vă rugăm să revizuiți acest lucru când aveți un moment. |
| ここはnullになる可能性があります。 | Koko wa null ni naru kanōsei ga arimasu. | Acest lucru ar putea deveni nul aici. |
| 変数名をもう少し具体的にしたほうがいいかもしれません。 | Hensū-mei o mō sukoshi gutaiteki ni shita hō ga ii kamo shiremasen. | Ar putea fi mai bine să faceți numele variabilei puțin mai specific. |
| この処理は別の関数に分けられそうです。 | Kono shori wa betsu no kansū ni wakeraresō desu. | Această logică pare că ar putea fi împărțită într-o funcție separată. |
| 念のため、テストを追加してもらえますか？ | Nen no tame, tesuto o tsuika shite moraemasu ka? | Doar pentru a fi în siguranță, ai putea adăuga un test? |
| 細かいですが、ここはタイポだと思います。 | Komakai desu ga, koko wa taipo da to omoimasu. | Minor, dar cred că este o greșeală de tipar. |
| ご指摘ありがとうございます。修正します。 | Go-shiteki arigatō gozaimasu. Shūsei shimasu. | Mulțumesc că ai subliniat asta. o voi repara. |
| ここは意図的にこうしています。理由は速度です。 | Koko wa itoteki ni kō shite imasu. Riyū wa sokudo desu. | Acest lucru este intenționat. Motivul este viteza. |
| 確認しました。問題ありません。 | Kakunin shimashita. Mondai arimasen. | am verificat. Nici o problemă. |
Aprobarea ajunge de obicei ca LGTM desu sau shōnin shimashita, iar o solicitare de extragere îmbinată primește adesea o linie māji shimashita în fir. Răspunde cu arigatō gozaimasu chiar și atunci când recenzia a fost dură; threadul este citit de toata echipa.
Raportarea unei erori și a unui incident
Un raport de eroare în japoneză are același schelet ca oriunde altundeva: ce s-a întâmplat, cum să îl reproduc, la ce te așteptai și ce ai primit. Cuvintele sunt saigen tejun pentru etapele de reproducere, kitai suru dōsa pentru comportamentul așteptat și jissai no dōsa pentru comportamentul real. Spune rōkaru de wa saigen shimasen când apare doar într-un singur mediu; acea propoziție economisește un recenzent o oră.
Un incident, shōgai, are o ordine mai strictă. Primul raport, daiippō, iese rapid și spune doar ce este stricat și cine este afectat. Cauza vine mai târziu, după chōsa, investigație, iar raportul de închidere adaugă saihatsu bōshi, prevenirea recurenței. Echipele japoneze vă judecă mult mai mult pe viteza primului mesaj decât pe caracterul complet al acestuia, așa că trimiteți-l înainte de a înțelege cauza.
| japonez | Romaji | Sens |
|---|---|---|
| 不具合を見つけました。 | Fuguai o mitsukemashita. | Am gasit un defect. |
| 本番でエラーが出ています。 | Honban de erā ga dete imasu. | Apar erori în producție. |
| 影響範囲はログイン画面だけです。 | Eikyō han'i wa roguin gamen dake desu. | Impactul este limitat la ecranul de conectare. |
| 再現手順は次のとおりです。 | Saigen tejun wa tsugi no tōri desu. | Pașii de reproducere sunt următorii. |
| ローカルでは再現しません。 | Rōkaru de wa saigen shimasen. | Nu se reproduce local. |
| 原因を調査中です。 | Gen'in o chōsa-chū desu. | investighez cauza. |
| 一旦ロールバックしてもいいですか？ | Ittan rōrubakku shite mo ii desu ka? | Pot să dau înapoi deocamdată? |
| 復旧しました。 | Fukkyū shimashita. | A fost restaurat. |
| 原因は設定ミスでした。再発防止策を考えます。 | Gen'in wa settei misu deshita. Saihatsu bōshi-saku o kangaemasu. | Cauza a fost o greșeală de configurare. Voi afla cum să previn o recidivă. |
Estimând și împingând încet un termen limită
Estimările sunt date în zile sau în persoane-zile, nin-nichi și înmuiate cu hodo sau kurai, adică despre. Mikka hodo desu este un răspuns normal; un număr gol fără un dedurizator sună ca o promisiune, iar promisiunile sunt amintite. Când data solicitată nu este realistă, cuvântul standard este kibishii, strâns, urmat imediat de o alternativă. Alternativa este ceea ce face ca respingerea să fie acceptabilă: o dată ulterioară, un domeniu mai mic sau o întrebare despre priorități care îi permite liderului să aleagă.
Dacă ai nevoie de timp să te gândești, ichido mochikaette kakunin shimasu, lasă-mă să-l iau și să verific, este o propoziție respectată. Semnalează că iei estimarea în serios în loc să ghicești pe loc și îți cumpără o zi.
| japonez | Romaji | Sens |
|---|---|---|
| 見積もりは三日ほどです。 | Mitsumori wa mikka hodo desu. | Estimarea este de aproximativ trei zile. |
| 工数は二人日くらいかかりそうです。 | Kōsū wa ni-nin-nichi kurai kakarisō desu. | Probabil că va dura aproximativ două persoane-zile. |
| 金曜日までは少し厳しいかもしれません。 | Kin'yōbi made wa sukoshi kibishii kamo shiremasen. | Vinerea poate fi puțin strânsă. |
| 来週の月曜日なら間に合います。 | Raishū no getsuyōbi nara ma ni aimasu. | Dacă este luni viitoare, pot să fac. |
| この機能を後回しにすれば、納期に間に合います。 | Kono kinō o atomawashi ni sureba, nōki ni ma ni aimasu. | Dacă amânăm această funcție, putem respecta termenul limită. |
| 優先順位を教えていただけますか？ | Yūsen jun'i o oshiete itadakemasu ka? | Îmi puteți spune ordinea de prioritate? |
| 一度持ち帰って確認します。 | Ichido mochikaette kakunin shimasu. | Lasă-mă să iau asta și să verific. |
Un lead poate răspunde cu jā, getsuyōbi de onegai shimasu, acceptând ziua de luni, sau cu nantoka narimsen ka, întrebând dacă se poate face ceva. Pentru al doilea, repetați comerțul cu lunetă, mai degrabă decât speleologia: kono kinō o hazuseba, kin'yōbi ni dekimasu, dacă renunțăm la această funcție, vineri este posibilă.
Citind un bilet japonez
Biletele sunt locul unde trăiește vocabularul kanji. Etichetele câmpului se repetă pe fiecare tracker, așa că învățarea a douăzeci dintre ele transformă un perete ilizibil într-un formular pe care îl puteți scana. Valorile de status sunt cele pe care le vei spune cu voce tare în stand-up, așa că citește-le cu pronunția lor, nu doar cu semnificația lor.
| Câmp de bilete | Romaji | Sens |
|---|---|---|
| 件名 | kenmei | titlu |
| 概要 | gaiyō | rezumat |
| 再現手順 | saigen tejun | pașii de reproducere |
| 期待する動作 | kitai suru dōsa | comportamentul așteptat |
| 実際の動作 | jissai no dōsa | comportament real |
| 優先度 | yūsendo | prioritate |
| 担当者 | tantōsha | cesionar |
| 期限 | kigen | data scadenței |
| ステータス | sutētasu | starea |
| 未着手 | michakushu | nu a început |
| 対応中 | taiō-chū | în curs |
| レビュー待ち | rebyū-machi | în așteptarea revizuirii |
| 保留 | horyū | în așteptare |
| 要確認 | yō-kakunin | necesită verificare |
| 対応済み | taiō-zumi | manipulate |
| 完了 | kanryō | făcut |
Un bilet scris de un coleg japonez se termină adesea cu yoroshiku onegai shimasu chiar și atunci când este doar un raport de eroare, iar comentariul tău se poate termina la fel. Când închideți un bilet, un taiō shimashita cu o singură linie, gestionat, cu un link către cererea de extragere este semnarea așteptată.
Eticheta instrumentului de chat
Chatul în echipă în Japonia este mai formal decât se așteaptă majoritatea inginerilor. Un mesaj direct se deschide de obicei cu otsukaresama desu, salutul universal la locul de muncă, iar o solicitare către o persoană ocupată adaugă o-tesuki no toki ni, atunci când aveți un moment. Marcați cu sinceritate urgența: isogi de wa arimasen îi spune cititorului că îl poate lăsa până după prânz, iar shikyū înseamnă să aruncați totul, așa că îl folosiți rar. O reacție emoji contează ca o recunoaștere pentru majoritatea echipelor, dar o solicitare din partea unei persoane în vârstă merită un shōchi shimashita dactilografiat.
Mesajele de prezență sunt normale în cultura japoneză de chat. Riseki shimasu când te îndepărtezi, modorimashita când te întorci și honjitsu wa agarimasu când te închizi pentru ziua respectivă. La început par agitați și devin automate într-o săptămână.
| japonez | Romaji | Sens |
|---|---|---|
| お疲れ様です。 | Otsukaresama desu. | Bună ziua (deschizătorul standard de chat între colegi). |
| お手すきの時に見ていただけますか？ | O-tesuki no toki ni mite itadakemasu ka? | Ai putea să arunci o privire când ai un moment? |
| 急ぎではありません。 | Isogi de wa arimasen. | Nu este urgent. |
| 至急確認をお願いします。 | Shikyū kakunin o onegai shimasu. | Vă rugăm să verificați acest lucru urgent. |
| 承知しました。 | Shōchi shimashita. | Înțeles. |
| 確認して、後ほど返信します。 | Kakunin shite, nochihodo henshin shimasu. | Voi verifica și voi răspunde mai târziu. |
| 取り急ぎご報告まで。 | Toriisogi go-hōkoku made. | Doar un raport rapid pentru moment. |
| 離席します。 | Riseki shimasu. | Mă îndepărtez de biroul meu. |
| 戻りました。 | Modorimashita. | M-am întors. |
| 本日は上がります。お疲れ様でした。 | Honjitsu wa agarimasu. Otsukaresama deshita. | Închidere pentru azi. Vă mulțumim pentru munca dvs. |
O rutină săptămânală pentru inginerie japoneză
- Spune-ți cu voce tare declarația înainte de întâlnire, în fiecare zi, folosind numele reale ale biletelor; trei propoziții durează mai puțin de un minut.
- Scrieți un comentariu de recenzie în japoneză pe zi, chiar și la solicitarea unui coleg pe care altfel ați fi aprobat-o în tăcere și utilizați de fiecare dată câte un formular de înmuiere.
- Citiți câte un bilet închis de la capăt la sfârșit în fiecare săptămână și spuneți istoricul statutului său: michakushu, taiō-chū, rebyū-machi, kanryō.
- Repetați primul raport de incident pentru un sistem pe care îl dețineți, astfel încât cuvintele să apară în ordine atunci când alerta reală se declanșează.
- Exersați o conversație cu termen limită pe săptămână în care oferiți o tranzacție cu scop în loc de un da.
- Păstrați o listă cu cuvintele împrumutate pe care le-ați pronunțat greșit la întâlniri și găsește-le vocalele lungi cu voce tare.