Termes d'ingénierie avec leurs lectures japonaises
La majeure partie du vocabulaire du domaine est constituée de katakana empruntés à l'anglais, ce qui est une bonne nouvelle pour la lecture et une mauvaise nouvelle pour l'écoute. Le serveur devient sābā avec deux voyelles longues et aucun son r, les données deviennent dēta, la libération devient rirīsu et la fusion devient māji. Si vous les prononcez avec des sons anglais, vos collègues risquent de ne pas les comprendre au rythme de la réunion et vous ne les reconnaîtrez peut-être pas en revenant. Apprenez chacun comme un mot japonais avec sa propre longueur et son propre rythme.
À côté de chaque emprunt, il y a généralement un mot kanji qui apparaît dans les tickets, les spécifications et les rapports formels. Bagu est le mot de conversation ; fuguai est ce qui figure dans le titre du billet. Tesuto est ce que vous faites ; Kenshō est ce que le rapport dit que vous avez fait. Les documents plus anciens suppriment également la voyelle longue finale de certains emprunts, vous rencontrerez donc sābā écrit comme サーバ et yūzā écrit comme ユーザ. Ce sont les mêmes mots.
| Terme | Romaji | Signification |
|---|---|---|
| バグ | bagu | bug (mot de tous les jours) |
| 不具合 | fuguaï | défaut, le mot formel pour un bug |
| サーバー | Saba | serveur |
| データ | dēta | données |
| テスト | tesuto | test |
| リリース | risu | libérer |
| デプロイ | dépuroi | déployer |
| マージ | maji | fusionner |
| プルリク | puru-riku | pull request (forme courte) |
| レビュー | rebyu | revoir |
| ログ | voyou | enregistrer |
| エラー | ère | erreur |
| 仕様 | Shiyo | spécification |
| 仕様書 | Shiyōsho | document de spécification |
| 要件 | joug | exigence |
| 設計 | sekkei | conception |
| 実装 | jisso | mise en œuvre |
| 改善 | Kaizen | amélioration |
| 修正 | shusei | réparer, corriger |
| 再現 | Saigen | reproduction d'un bug |
| 検証 | Kenshō | vérification, test d'un correctif |
| 本番 | Honban | environnement de production |
| 開発環境 | Kaihatsu Kankyō | environnement de développement |
| 障害 | shōgai | incident, panne |
| 影響範囲 | eikyō han'i | portée de l'impact |
| 納期 | noki | délai de livraison |
| 工数 | kōsū | effort, heures-personnes |
| 見積もり | mitsumori | estimation |
| 進捗 | shinchoku | progrès |
| 対応 | taio | manipuler, gérer |
| 運用 | un'yō | opérations |
| 保守 | hoshu | entretien |
| デグレ | dégure | régression, de dégradation |
| リスケ | risque | reprogrammer |
| エビデンス | ebidensu | une preuve, généralement une capture d'écran montrant un test réussi |
Le stand-up quotidien en trois parties
La réunion du matin, souvent appelée asakai ou quotidien, suit partout les mêmes trois questions : ce que vous avez fait hier, ce que vous ferez aujourd'hui et si quelque chose vous bloque. Préparez trois phrases, pas une histoire. Kinō wa pour hier, kyō wa pour aujourd'hui, et soit burokkā wa toku ni arimasen, soit un endroit précis où vous êtes coincé. Dire gambarimasu au lieu d’un statut concret est une erreur courante ; le responsable veut un nom de tâche et un état.
Les mots de progrès comptent. Yotei dōri signifie dans les délais, sukoshi okurete imasu signifie légèrement en retard et kyō-jū ni owaru mikomi desu signifie que vous comptez terminer aujourd'hui. Si vous êtes en retard, dites-le lors du stand-up plutôt que dans un message la veille de la date limite ; une équipe japonaise pardonne un retard dont elle a entendu parler très tôt.
| japonais | Romaji | Signification |
|---|---|---|
| 昨日はログイン機能の実装を進めました。 | Kinō wa roguin kinō no jissō o susumemashita. | Hier, j'ai progressé dans la mise en œuvre de la fonctionnalité de connexion. |
| 今日はテストを書いて、プルリクを出す予定です。 | Kyō wa tesuto o kaite, puru-riku o dasu yotei desu. | Aujourd'hui, je prévois d'écrire des tests et d'ouvrir une pull request. |
| ブロッカーは特にありません。 | Burokkā wa toku ni arimasen. | Pas de bloqueurs en particulier. |
| APIの仕様が決まっていないので、そこで止まっています。 | API no shiyō ga kimatte inai node, soko de tomatte imasu. | La spécification de l'API n'est pas encore réglée, donc je suis bloqué là. |
| 進捗は予定どおりです。 | Shinchoku wa yotei dōri desu. | Les progrès sont dans les délais. |
| 少し遅れています。 | Sukoshi okurete imasu. | Je suis un peu en retard. |
| 今日中に終わる見込みです。 | Kyō-jū ni owaru mikomi desu. | Je pense avoir terminé d'ici la fin de la journée. |
| 田中さんに確認したいことがあります。 | Tanaka-san ni kakunin shitai koto ga arimasu. | J'ai quelque chose que je veux vérifier avec Tanaka. |
Un prospect peut répondre par un bref suivi tel que itsu-goro owarisō desu ka, demandant approximativement quand il se terminera, ou dare ka tetsudaimashō ka, offrant de l'aide. Répondez avec une journée et une tâche, et prenez de l'aide si le bloqueur est hors de votre contrôle.
Demander une spécification et confirmer votre compréhension
Les conversations de spécification au Japon se déroulent selon le modèle iu rikai de atte imasu ka, ce qui signifie que ma compréhension est correcte. Vous reformulez ce que vous pensez que dit la spécification, dans vos propres mots, et laissez l'autre personne confirmer ou corriger. Ce n’est pas un signe de faiblesse ; l'expression ninshiki éveillé, alignant la compréhension, est quelque chose que les ingénieurs supérieurs demandent constamment. L’erreur est de dire wakarimashita tôt pour mettre fin à la discussion, puis de construire la mauvaise chose.
Demandez où une règle est écrite avec shiyōsho no doko ni kaite arimasu ka. Si ce n'est écrit nulle part, la réponse sera souvent un haussement d'épaules, et c'est votre signal pour proposer le comportement vous-même et demander l'accord, ce qui permet également de l'écrire.
| japonais | Romaji | Signification |
|---|---|---|
| この仕様について確認させてください。 | Kono shiyō ni tsuite kakunin sasete kudasai. | Permettez-moi de confirmer quelque chose à propos de cette spécification. |
| エラーの場合は、画面にメッセージを出すという理解で合っていますか？ | Erā no baai wa, gamen ni messēji o dasu to iu rikai de atte imasu ka? | Ai-je raison de dire qu'en cas d'erreur, nous affichons un message à l'écran ? |
| この場合はどう動くべきですか？ | Kono baai wa dō ugoku beki desu ka? | Comment doit-il se comporter dans ce cas ? |
| 仕様書のどこに書いてありますか？ | Shiyōsho no doko ni kaite arimasu ka? | Où est-ce écrit dans le document de spécification ? |
| 認識合わせをさせてください。 | Ninshiki awase o sasete kudasai. | Permettez-moi de m’assurer que nous sommes sur la même longueur d’onde. |
| 要件を整理してもいいですか？ | Yōken o seiri shite mo ii desu ka? | Puis-je résumer les exigences ? |
| はい、その理解で合っています。 | Hai, sono rikai de atte imasu. | Oui, cette compréhension est correcte. |
| いえ、そこは少し違います。 | Ie, soko wa sukoshi chigaimasu. | Non, cette partie est un peu différente. |
| では、その内容でチケットに書いておきます。 | Dewa, sono naiyō de chiketto ni kaite okimasu. | Ensuite, j'écrirai cela sur le ticket. |
Commentaires de révision de code directs mais polis
Un bon commentaire japonais nomme clairement le problème et adoucit uniquement les instructions. Koko wa null ni naru kanōsei ga arimasu énonce le risque sans couverture. Le correctif arrive alors sous forme de suggestion : shita hō ga ii kamo shiremasen, ce qui signifie qu'il pourrait être préférable de le faire, ou wakeraresō desu, ce qui signifie que cela semble pouvoir être divisé. Les petits points de style sont marqués de komakai desu ga, mineur mais, et un simple kudasai de merde d'un critique junior se lit comme un ordre, alors conservez-le pour le ton d'un lead ou un bug clair.
En tant qu'auteur, remerciez le critique avec go-shiteki arigatō gozaimasu et dites ce que vous ferez. Si le code est intentionnel, dites-le avec itoteki ni et donnez-en la raison ; un critique japonais attend une raison, pas une défense. L'échange ci-dessous montre les deux côtés d'une demande de tirage.
| japonais | Romaji | Signification |
|---|---|---|
| お手すきの時にレビューをお願いします。 | O-tesuki no toki ni rebyū o onegai shimasu. | Veuillez consulter ceci lorsque vous aurez un moment. |
| ここはnullになる可能性があります。 | Koko wa null ni naru kanōsei ga arimasu. | Cela pourrait devenir nul ici. |
| 変数名をもう少し具体的にしたほうがいいかもしれません。 | Hensū-mei o mō sukoshi gutaiteki ni shita hō ga ii kamo shiremasen. | Il serait peut-être préférable de rendre le nom de la variable un peu plus précis. |
| この処理は別の関数に分けられそうです。 | Kono shori wa betsu no kansū ni wakeraresō desu. | Cette logique semble pouvoir être divisée en une fonction distincte. |
| 念のため、テストを追加してもらえますか？ | Nen no tame, tesuto o tsuika shite moraemasu ka? | Par mesure de sécurité, pourriez-vous ajouter un test ? |
| 細かいですが、ここはタイポだと思います。 | Komakai desu ga, koko wa taipo da to omoimasu. | Mineur, mais je pense que c'est une faute de frappe. |
| ご指摘ありがとうございます。修正します。 | Go-shiteki arigatō gozaimasu. Shūsei shimasu. | Merci de l'avoir signalé. Je vais le réparer. |
| ここは意図的にこうしています。理由は速度です。 | Koko wa itoteki ni kō shite imasu. Riyū wa sokudo desu. | C'est intentionnel. La raison est la vitesse. |
| 確認しました。問題ありません。 | Kakunin shimashita. Mondai arimasen. | J'ai vérifié. Aucun problème. |
L'approbation arrive généralement sous la forme LGTM desu ou shōnin shimashita, et une demande d'extraction fusionnée obtient souvent un māji shimashita d'une seule ligne dans le fil de discussion. Répondez avec arigatō gozaimasu même lorsque la critique a été grossière ; le fil est lu par toute l'équipe.
Signaler un bug et un incident
Un rapport de bug en japonais a le même squelette que partout ailleurs : ce qui s'est passé, comment le reproduire, ce que vous attendiez et ce que vous avez obtenu. Les mots sont saigen tejun pour les étapes de reproduction, kitai suru dōsa pour le comportement attendu et jissai no dōsa pour le comportement réel. Dites rōkaru de wa saigen shimasen lorsqu'il n'apparaît que dans un seul environnement ; cette phrase fait gagner une heure à un critique.
Un incident, shōgai, a un ordre plus strict. Le premier rapport, daiippō, sort rapidement et dit seulement ce qui est cassé et qui est affecté. La cause vient plus tard, après chōsa, l'enquête, et le rapport final ajoute saihatsu bōshi, la prévention de la récidive. Les équipes japonaises vous jugent bien plus sur la rapidité du premier message que sur son exhaustivité, alors envoyez-le avant d'en comprendre la cause.
| japonais | Romaji | Signification |
|---|---|---|
| 不具合を見つけました。 | Fuguai o mitsukemashita. | J'ai trouvé un défaut. |
| 本番でエラーが出ています。 | Honban de erā ga dete imasu. | Des erreurs se produisent dans la production. |
| 影響範囲はログイン画面だけです。 | Eikyō han'i wa roguin gamen dake desu. | L'impact est limité à l'écran de connexion. |
| 再現手順は次のとおりです。 | Saigen tejun wa tsugi no tōri desu. | Les étapes à reproduire sont les suivantes. |
| ローカルでは再現しません。 | Rōkaru de wa saigen shimasen. | Il ne se reproduit pas localement. |
| 原因を調査中です。 | Gen'in o chōsa-chū desu. | J'étudie la cause. |
| 一旦ロールバックしてもいいですか？ | Ittan rōrubakku shite mo ii desu ka? | Puis-je revenir en arrière pour l'instant ? |
| 復旧しました。 | Fukkyū shimashita. | Il a été restauré. |
| 原因は設定ミスでした。再発防止策を考えます。 | Gen'in wa settei misu deshita. Saihatsu bōshi-saku o kangaemasu. | La cause était une erreur de configuration. Je vais trouver comment éviter une récidive. |
Estimer et repousser un délai en douceur
Les estimations sont données en jours ou en jours-personnes, nin-nichi, et adoucies par hodo ou kurai, ce qui signifie environ. Mikka hodo desu est une réponse normale ; un simple numéro sans adoucisseur sonne comme une promesse, et les promesses sont mémorisées. Lorsque la date demandée n'est pas réaliste, le mot standard est kibishii, serré, suivi immédiatement d'une alternative. L’alternative est ce qui rend le refus acceptable : une date ultérieure, une portée plus petite ou une question sur les priorités qui laisse le responsable choisir.
Si vous avez besoin de temps pour réfléchir, ichido mochikaette kakunin shimasu, laissez-moi l'enlever et vérifier, est une phrase respectée. Cela indique que vous prenez l’estimation au sérieux plutôt que de deviner sur place, et cela vous fait gagner une journée.
| japonais | Romaji | Signification |
|---|---|---|
| 見積もりは三日ほどです。 | Mitsumori wa mikka hodo desu. | L'estimation est d'environ trois jours. |
| 工数は二人日くらいかかりそうです。 | Kōsū wa ni-nin-nichi kurai kakarisō desu. | Cela prendra probablement environ deux jours-personnes. |
| 金曜日までは少し厳しいかもしれません。 | Kin'yōbi made wa sukoshi kibishii kamo shiremasen. | Vendredi, ça risque d'être un peu serré. |
| 来週の月曜日なら間に合います。 | Raishū no getsuyōbi nara ma ni aimasu. | Si c'est lundi prochain, je peux y venir. |
| この機能を後回しにすれば、納期に間に合います。 | Kono kinō o atomawashi ni sureba, nōki ni ma ni aimasu. | Si nous reportons cette fonctionnalité, nous pouvons respecter le délai. |
| 優先順位を教えていただけますか？ | Yūsen jun'i o oshiete itadakemasu ka? | Pourriez-vous me dire l'ordre de priorité ? |
| 一度持ち帰って確認します。 | Ichido mochikaette kakunin shimasu. | Laissez-moi enlever ça et vérifier. |
Un responsable peut répondre par jā, getsuyōbi de onegai shimasu, en acceptant lundi, ou par nantoka narimasen ka, en demandant si quelque chose peut être fait. Au second, répéter le commerce de scope plutôt que de spéléologie : kono kinō o hazuseba, kin'yōbi ni dekimasu, si on laisse tomber cette fonctionnalité, vendredi est possible.
Lire un billet japonais
Les billets sont le lieu où réside le vocabulaire kanji. Les étiquettes des champs se répètent sur chaque tracker, donc en apprendre vingt transforme un mur illisible en un formulaire que vous pouvez numériser. Les valeurs de statut sont celles que vous prononcerez à haute voix lors du stand-up, alors lisez-les avec leur prononciation, pas seulement leur signification.
| Champ du ticket | Romaji | Signification |
|---|---|---|
| 件名 | Kenmei | titre |
| 概要 | gaiyō | résumé |
| 再現手順 | Saigen Tejun | étapes pour reproduire |
| 期待する動作 | kitai suru dosa | comportement attendu |
| 実際の動作 | jissai no dosa | comportement réel |
| 優先度 | Yusendo | priorité |
| 担当者 | tantōsha | cessionnaire |
| 期限 | kigen | date d'échéance |
| ステータス | sutetasu | statut |
| 未着手 | michakushu | pas commencé |
| 対応中 | taiō-chū | en cours |
| レビュー待ち | rebyu-machi | en attente d'examen |
| 保留 | horyū | en attente |
| 要確認 | yō-kakunin | doit être vérifié |
| 対応済み | taiō-zumi | manipulé |
| 完了 | kanryō | fait |
Un ticket rédigé par un collègue japonais se termine souvent par yoroshiku onegai shimasu même s'il ne s'agit que d'un rapport de bug, et votre commentaire peut se terminer de la même manière. Lorsque vous fermez un ticket, un taiō shimashita d'une seule ligne, traité, avec un lien vers la demande d'extraction est la signature attendue.
Étiquette des outils de discussion
Au Japon, les discussions en équipe sont plus formelles que ce à quoi s'attendent la plupart des ingénieurs. Un message direct s'ouvre généralement par otsukaresama desu, le message d'accueil polyvalent sur le lieu de travail, et une demande adressée à une personne occupée ajoute o-tesuki no toki ni, lorsque vous avez un moment. Marquez honnêtement l'urgence : isogi de wa arimasen dit au lecteur qu'il peut le laisser jusqu'après le déjeuner, et shikyū signifie tout laisser tomber, donc utilisez-le rarement. Une réaction emoji compte comme une reconnaissance dans la plupart des équipes, mais une demande d'une personne senior mérite un shōchi shimashita tapé.
Les messages de présence sont normaux dans la culture de chat japonaise. Riseki shimasu lorsque vous vous éloignez, modorimashita à votre retour et honjitsu wa agarimasu lorsque vous quittez la journée. Ils semblent difficiles au début et deviennent automatiques en une semaine.
| japonais | Romaji | Signification |
|---|---|---|
| お疲れ様です。 | Otsukaresama desu. | Bonjour (l'ouvre-chat standard entre collègues). |
| お手すきの時に見ていただけますか？ | O-tesuki no toki ni mite itadakemasu ka? | Pourriez-vous y jeter un œil quand vous aurez un moment ? |
| 急ぎではありません。 | Isogi de wa arimasen. | Ce n'est pas urgent. |
| 至急確認をお願いします。 | Shikyū kakunin o onegai shimasu. | Veuillez vérifier cela de toute urgence. |
| 承知しました。 | Shōchi shimashita. | Compris. |
| 確認して、後ほど返信します。 | Kakunin shite, nochihodo henshin shimasu. | Je vérifierai et répondrai plus tard. |
| 取り急ぎご報告まで。 | Toriisogi go-hōkoku made. | Juste un petit rapport pour l'instant. |
| 離席します。 | Riseki shimasu. | Je m'éloigne de mon bureau. |
| 戻りました。 | Modorimashita. | Je suis de retour. |
| 本日は上がります。お疲れ様でした。 | Honjitsu wa agarimasu. Otsukaresama deshita. | Je me déconnecte pour aujourd'hui. Merci pour votre travail. |
Une routine hebdomadaire pour l'ingénierie japonaise
- Dites votre stand-up à haute voix avant la réunion, tous les jours, en utilisant les vrais noms des billets ; trois phrases prennent moins d’une minute.
- Écrivez un commentaire d'évaluation en japonais par jour, même sur la pull request d'un collègue que vous approuveriez autrement en silence, et utilisez un formulaire d'adoucissement à chaque fois.
- Lisez un ticket fermé de bout en bout chaque semaine et racontez son historique de statut : michakushu, taiō-chū, rebyū-machi, kanryō.
- Répétez un premier rapport d'incident pour un système que vous possédez, afin que les mots apparaissent dans l'ordre lorsque la véritable alerte se déclenche.
- Pratiquez une conversation sur la date limite par semaine dans laquelle vous proposez un échange de portée au lieu d'un oui.
- Gardez une liste des emprunts que vous avez mal prononcés lors des réunions et percez leurs voyelles longues à haute voix.