業界用語を平易な言葉にする
専門用語・略語・業界の言い回しを一度に片付ける
以下の [分野] の資料には業界用語が多く含まれています。対照表を作ってください：用語／字義／この文脈での実際の意味／知らないと何を見落とすか。要件：1）私が知らなさそうな語だけを載せる。常識語は不要；2）混同しやすい類義語は別の行に分けて違いを説明；3）業界で複数の使われ方がある語は、どれに当たるかを明示；4）最後に、予備知識なしで読めるよう全体を 100 字で書き換える。 [資料を貼り付け]
使い方
原文より先に表を読む。格段に速い。類義語の行は単独でも残す価値がある。
向いている場面
- 隣接領域の仕様書や契約書を読んでいて、単語は全部知っているのに、つなげると何をすればいいか分からないとき
- 文書は読めたつもりだったのに、自分で設定しようとした瞬間、その語が何を制約するのか分からないと気づいたとき
向いていない場面
- 資料自体がすでに平易な言葉で書かれているとき（初心者向けのチュートリアル）。解読すると存在しない専門用語を作り出す
- 法的・コンプライアンス上の確定した解釈が必要なとき。用語表は読む助けになるが、法務の意見の代わりにはならない
例
入力
Pod の QoS class は、コンテナが requests と limits を設定しているかで決まる。Guaranteed は全コンテナが CPU とメモリの requests と limits を等しく設定していること。Burstable は少なくとも一つのコンテナが requests か limits を設定していること。BestEffort はどれも設定していないこと。ノードのメモリ圧迫時、kubelet は BestEffort、Burstable、Guaranteed の順に Pod を退避させる。
得られるもの
対応表は QoS class、requests、limits、eviction の四語を扱い、字面の意味だけでなく「requests はスケジューリングに効き、limits は実行時に殺されるかどうかに効く」と示す。類義語の弁別は独立した行にする（requests と limits、eviction と OOMKill）。最後の百字の書き換えは、Kubernetes に触れたことのない人にも「requests を書かない Pod が最初に追い出される」と伝わるものであること。
よくある誤用
- 「すべての用語を挙げて」と頼み、四十行の表を受け取る。三十行はすでに知っている語で、本当に詰まっていた二語は曖昧なまま残る
- 「分からないと何を見落とすか」の列を飛ばす。利害のない辞書が返り、読んでもどこでつまずくか分からない
こう変えると効く
- 「詰まっている段落を文ごとに訳して。表は不要」と足す。一つの段落が未知語だらけのときに向く
- 読み手を「技術に詳しくない上司に説明する」に変える。書き換えはたとえと取捨を入れ替えるので、本当に分かっているか確かめられる