コードは英語でできている。
だから英語は“開発の速度”になる。
プログラミング言語そのものより、周辺の言語が英語(命名・設計・説明・合意)。
英語が効く場所(コード周辺が本丸)
• Naming(変数・関数・クラス名)
• Errors(エラー文)
• Docs(README, API docs)
• Tickets(Jira, Issues)
• PR(Pull Request)
• Reviews(レビューコメント)
• Errors(エラー文)
• Docs(README, API docs)
• Tickets(Jira, Issues)
• PR(Pull Request)
• Reviews(レビューコメント)
良い命名は“英語の作文”
Bad doThing / data2 / flag
Good calculateTax / userProfile / isPaymentConfirmed
エラー英語を読むコツ
- 動詞を探す(failed / expected / missing / denied)
- 対象を探す(file / token / permission / parameter)
- 原因の手掛かり(because / due to / caused by)
“英語で書けると強い”最小セット
Problem: …
Expected: …
Actual: …
Steps to reproduce:
1) …
2) …
Environment: …
Impact: …
今日の勝ち(3分)
仕事のメモを英語で1行:
I’m working on … to …
目的(to …)まで書くと、伝わる。
I’m working on … to …
目的(to …)まで書くと、伝わる。