🦔

「公式ドキュメント見ればいいじゃん」と思うけどそれでも解説記事を書く理由

に公開

なぜ英語ドキュメントの解説記事を書いているのか

最近、Zennで英語の公式ドキュメントやブログ記事を読んで、それを日本語で解説する記事をいくつか書いています。

この記事では、なぜそういった活動をしているのか、自分の考えを書いてみます。

原文を読む人は少ない

正直なところ、英語の公式ドキュメントを読む日本人エンジニアは多くないと思っています。

もちろん、英語が得意な人や、最新情報をキャッチアップする習慣がある人は読んでいるでしょう。でも、全体で見れば少数派ではないでしょうか。

理由はいろいろあると思います。

  • 翻訳ツールを通しても、技術的なニュアンスが伝わりにくい
  • スマホで翻訳がめんどくさい
  • 翻訳してもレイアウト崩れて読みにくい。読む気を失う
  • そもそも公式ドキュメントの存在を知らない
  • 日本語の情報が出るまで待っている

どれも自然なことだと思います。

誰かが日本語で出せば、触れる人が増える

私が解説記事を書いている理由はシンプルで、日本語で情報を出せば、それに触れる人が増えるから です。

英語の壁があるだけで、本当は興味があるのに情報にアクセスできていない人がいる。初心者であればなおさらです。

そういう人たちが、日本語の解説記事をきっかけに「こういう技術があるんだ」「こういう考え方があるんだ」と知るきっかけになれば嬉しいなと思っています。

AIを活用して書いている

正直に言うと、記事の執筆にはAIを活用しています。

ただ、AIに丸投げしているわけではありません。私自身が原文を読んで内容を理解した上で、AIが書いた記事をレビューしています。事実として間違っていないか、ニュアンスがずれていないか、ちゃんと確認しています。

AIを使うことで、記事を書くスピードは上がります。でも、内容の正確さを担保するのは人間の役割だと思っています。

完璧な翻訳ではないけれど

私の記事は、厳密な翻訳ではありません。

原文を読んで、自分なりに理解して、自分の言葉でまとめ直しています。解釈が間違っていることもあるかもしれません。

でも、それでも「何も情報がない」よりはマシだと思っています。

私の記事を読んで興味を持った人が、原文を読みに行くきっかけになればそれでいい。完璧じゃなくても、入り口としての役割を果たせればいいと考えています。

自分の学習にもなっている

もちろん、記事を書くことは自分の学習にもなっています。

ドキュメントを読んで、理解して、人に伝わるようにまとめる。このプロセスを通じて、自分の理解も深まります。

AIの出力をレビューする過程でも、「ここは原文と違うな」「この表現はわかりにくいな」と気づくことがあり、それも学びになっています。

「いいね」がモチベーション

もし私の記事を読んでくれている人がいたら、ありがとうございます。

「英語のドキュメントは読めないけど、日本語の解説があるから助かる」

そう思ってもらえたら、記事を書いている意味があります。

そして、もし余裕があれば、原文にもチャレンジしてみてください。私の記事は入り口に過ぎないので、より正確で詳細な情報は原文にあります。

これからも、気になる英語ドキュメントがあれば、解説記事を書いていこうと思います。

そして「いいね」をぜひ押してもらえると嬉しいです。
私だけでなく、「いい記事だな」「勉強になったな」「後で見返したいな」、そんな記事はいいねをつけておきましょう。

思ったよりブログを書いている人は1つのいいねが嬉しいものです。

Discussion