外国語のドキュメントの読み解き方

Question

使いたいライブラリに外国語のドキュメントしかないとき、どうやって学習しますか？

Comments

[momon-ga]

外国語を翻訳する以外にですか？

Answer 1

単語の意味を調べながらでも英語の物が読めなければ、英語を勉強するということで。
文法的には中学英語をマスターしてればほぼ読めると思います。

英語以外の物しか無ければ、機械翻訳に頼るくらいですね。
ヨーロッパの言語であれば、日本語に翻訳してわかりにくければ、英語に翻訳して英語で読むと良いかもしれません。

Answer 2

普段やっているのは、

• そのまま読む
• 翻訳して公開されている文章を探す
• 機械翻訳しながら読む
  ぐらいでしょうか。

ライブラリ等で、ソースコードが公開されている場合は、ドキュメントを読むのを諦めて、ソースコードを読んで、動作を確認する場合もあります。

Answer 3

英語なら機械翻訳とそのライブラリの扱う分野の基本的な知識があればなんとかなることが多いです。
これで完全に無理な感じならお金を払ってわかっている人に教えてもらうか、基礎知識をもう少しつけるか、諦めて日本語のドキュメントの多いライブラリを選択します。
（自分やチームにとって情報を取得しやすいライブラリを選択するという事は重要なことだと思います。）

（ある程度メジャーなライブラリに限定されますが）その後実際に使ってみて、エラーが出たらそのライブラリのコミュニティかStack OverFlowで検索すれば何とかなる確率はさらに上がります。

それでもどうにもならなかったら、これも機械翻訳で良いので同様の場所で質問してみて、それでもダメならわかるところから順にソースを読んでいくという感じでしょうか。

Answer 4

下手すると外国語であっても「ドキュメントがあるだけマシ」だったりするので、公開されているソースコードから追いかけるとか、試行錯誤になることは多いですよ。

Answer 5

その外国語が英語ならそのまま読みます。
説明するために書かれたドキュメントなので、例とか書いてあるし、知らない単語が出てきたらググれば詳細な情報が手に入るので、そこまで難しくはないのではないかと。

英語以外なら……英語のドキュメントを探して無かったら諦めます。

Comments

[shinpo]

質問なのですが、
>英語以外なら……英語のドキュメントを探して無かったら諦めます。
ここで言うあきらめるというのは他の回答者さんが仰っているようにソースコードを読んで、動作を確認するということですか？

[oskbt]

ドキュメントは無かったっということです。

ソースコードを読むか、それとも別のライブラリを探すか、はたまた自作するかはそのときの状況によります。