Between uniqueness and easy-to-understand / 一意性とわかりやすさのはざまで

久しぶりにTechnical Issueの翻訳。

多忙な同僚のかわりに翻訳を引き受けてみた。対象がCompiler のBug Reportなので、いつも以上に気合が入る。Compiler のBug Reportの場合、A)エンドユーザにとってわかりやすいこと。B)どんな読み方をしても発生条件が一意に取れること。この相反する二つの条件を満たしていなければならない。

コンパイラの不具合の場合、不具合は概してS/Wの奥深いところで発生する。コンパイラに限らず完成度の高いS/Wの場合、そうだ。そして不具合の発生は、避けて通れない問題。コンパイラの場合、内部は中間形式を用いて処理されるため、エンドユーザが使用するCなどの高級言語との透過性はおちる。これが、わかりにくさの原因の一つ。

だから、単純に書きすぎると適合範囲が広まってしまい、品質管理を問題視されてしまう。かといって、難しく書きすぎると今度は合致の確認が難しくなるため、合致確認の問い合わせが増えてサポートコストがかさんでしまう。

自分が取り扱う文書中でもかなり難しい部類だと思っています。Compiler のBug Reportは、日本語でもこれがちゃんと書けたらサポートエンジアとして一人前です。

予定の２倍の時間をかけてようやく翻訳が完了。自分としては、スペルチェックもかけたし、読み直して(*)みてそこそこできていると思っていたので、提出する前に師匠(Jedi Master)に、Reviewしてもらった。そしたら、あららら…、コテンパンにやっつけられました。文法の間違いや、言葉の使い方などかなりレベルの低いものもあり、恥ずかしい限り。

(*)　一端翻訳した文書　英語→日本語の機械翻訳にかけてみると、実は、文法のチェックができます。


今回の指摘で面白かったのは、不具合の条件を満たすの「満たす」の英訳として、これまで何気なく、Satisfyを使っていたが、一笑にふされた。Satisfyには、うまくいってうれしいというニュアンスの満たすであるので、不具合の条件に合致してうれしいか…と。けだし名言である。

Books: The Elements of Style

A movement of making English the second official language is arising in Japan.

Actually there is no day when I write in English. However, I'm not sure my writing is correct. Even it is wrong, no one points to me. Unfortunately, many Japanese think correct spelling is right writing. Kidding!!

I found a master in my office with a great effort. I call him Jedi Master. He said he had no pupil, but I don't feel unwelcome.

This is a book Jedi Master recommended.
He said,

"I never lend my book. You can buy this on Amazon, but it's very easy to find PDF on web."

And　He continued,

"There is nothing to be afraid of, because even educated Americans need such kind of book"

Complicated Specification

Sometimes, a TSE(*) guy requests new spec of S/W. His requested specs are always very complicated. Every time he requests, I think that no one use but YOU!
However, at the same time, his requests are always interested on the technical side.

One day, I talked about this with my master. He is compiler expert, a person of wisdom. I call him Jedi Master secretly.

I: "No one use such complicated spec. Had I better make him know?"
JM: "That's bad joke, and you are very lucky."
I: "Did I? Kidding!!"
JM: "He requested. If he were a developer, you are more unlucky."
He smiled and said.
JM: "Once, I was a such kind of engineer"

Note:
TSE = Technical Support Engineer