しないでマイクロソフトのスタイルガイドライン準拠の翻訳
マイクロソフトは将来的に買収する見込みのGitHubで.NETのドキュメントを公開している。ハロウィーン文書が公開された頃のマイクロソフトからは考えられないほど変わったものだ。
https://github.com/dotnet/docs.ja-jp
その中にある変数名の命名規則に関するスタイルガイドラインについて書かれたドキュメントの文章がおかしい。
しないで動詞または動詞句は、メソッドの名前を指定します。
しないで名詞、名詞句、または形容詞を使用してプロパティの名前を付けます。
しないで次の例のように、"Get"メソッドの名前に一致するプロパティがあります。
しないで後に"List"または"Collection"単数形の語句を使用する代わりに、コレクション内の項目を記述する複数形の語句でコレクションのプロパティの名前を付けます
日本語として極めて不自然な文章になっていて意味がわからない。
原文は英語で書かれている。
https://github.com/dotnet/docs/blob/master/docs/standard/design-guidelines/names-of-type-members.md
原文を確認するとようやく意味がわかる。
DO give methods names that are verbs or verb phrases.
DO name properties using a noun, noun phrase, or adjective.
DO NOT have properties that match the name of "Get" methods as in the following example:
DO name collection properties with a plural phrase describing the items in the collection instead of using a singular phrase followed by "List" or "Collection."
なるほど、"DO"を間違えて「しないで」と訳してしまったのだな。"DO NOT"も「しないで」と訳されている。翻訳する上で間違えて機械的に置換でもしたのだろう。原文の文章の形をなるべく維持したまま日本語に訳すならば、"DO"を「正：」、"DO NOT"を「誤：」とでもすればいいのだろう。ただ、その場合"DO NOT"を使った文中で代替案も示してしまっているのが問題なので、これはできれば原文自体を「すべきこと」と「すべきでないこと」に分割すべきだろう。
そして間違いが20日にissueで指摘された。
https://github.com/dotnet/docs.ja-jp/issues/118
そして土日を挟んで今日、マイクロソフトから正式に回答があった。
https://github.com/dotnet/docs.ja-jp/issues/118#issuecomment-407202477
こんにちは、@megascus
言語に関するフィードバックをお寄せいただきありがとうございました。
お寄せいただいたフィードバックの内容を Microsoft の言語チームで検証いたしましたところ、残念ながら、マイクロソフトのスタイルガイドラインに従わない という理由で、承認基準に完全には適合していないという結果になりました。
記事の品質向上にご協力いただき誠にありがとうございました。引き続きお客様からの貴重なフィードバックをお待ちしています。
敬具
Microsoft DOCS International Team
そしてissueはclosedされた。
ん？ である。問題は日本語の翻訳にあるのであってソースコードのスタイルガイドラインとは何の関係もない。上記の日本語を読解できるだけの日本語能力があるならば容易に気がつくはずで、まるでBOTによってなされたような回答だ。
その結果、マイクロソフト用語では"DO"は「しないで」を意味するのだとか、マイクロソフト社内では"DO"と"DO NOT"は同じ意味を持つのだとか、Google翻訳のほうがよっぽどマシな翻訳をしてくれるとか、ユーモラスなコメントが並ぶことになった。
マイクロソフト用語を使うと以下のようになる。
DO fix the document which has a translation error.
しないで誤訳を含むドキュメントの修正
DO translate with MS style guideline conformance.
しないでMSスタイルガイドライン準拠の翻訳
押すなよ、絶対押すなよ(押せ)、というダチョウ倶楽部メソッドを久しぶりに思い出してしまった。