OptionalのJavadocの日本語訳を直して欲しい
日本語訳が微妙というだけなんです
Java 11 以降で追加された、Optional の Javadoc の説明を直して欲しい。 Javadoc の日本語訳が微妙なのは全体的な話なので、メンバーには英語の方を見て確認をするように促しているんですが、やはり英語にアレルギーを持っている人も一定数存在するので、翻訳の精度が上がるのは嬉しい。
apiNote:
Optionalis primarily intended for use as a method return type where there is a clear need to represent "no result," and where usingnullis likely to cause errors. A variable whose type isOptionalshould never itself benull; it should always point to anOptionalinstance.
APIのノート:
Optionalは、主に"検索結果はありません、"を明示的に表示する必要があり、nullを使用するとエラーが発生する可能性のあるメソッドの戻り値の型として使用することを意図しています。 型がOptionalの変数は、それ自体決してnullであってはなりません。常にOptionalインスタンスを指す必要があります。
…"検索結果はありません、"… と翻訳されている所を、素直に …"結果がないこと"… と訳して欲しい、それだけです。 私の拙い英語読解力を持ってしても、原文には 検索結果 を意味する要素は含まれていないように見えるのです。
ちなみに、DeepLで翻訳した結果は、次のような自然な文章になりました。
APIのノート:
Optionalは主に、メソッドの戻り値の型として使用することを意図しています。ここでは、「結果がない」ことを表現する必要があり、nullを使用するとエラーが発生する可能性が高い場合です。Optional型の変数は、決してnullになってはいけません。常にOptionalのインスタンスを指すようにしなければなりません。
Discussion