技術文の書き方について考えてみた

技術記事を書くのが好きです、特にその背後にある原理を深く探ることができるものに魅了されています。全く異なる定理のように見えるものでも、その核心にある理念が同じであることに興奮します。

例えば、私は興味本位の研究旅行で、逆行列、特異値分解、離散コサイン変換について書いたことがあります。これらは動作方法や公式が異なりますが、核心的な思想は似ています — 直感的な答えが最適解でないこともあり、時には遠回りをして角度を変える（別のベクトル空間に変える）ことで、物事がずっと簡単になります。

これは私が昨年（2023年）に参加したアイアンマンコンテストのシリーズ記事で、自己挑戦の一環でしたが、参加した中で最も気に入っているシリーズです。

なぜ？

技術記事はさらにいくつかのカテゴリに細分化できることに気づきました。教育記事、解説記事、操作ガイド（manual）、見解などです。私は教育や操作ガイドタイプの記事を書くのがあまり好きではありません。

これらの記事にはもちろん価値があり、仕事上でもよく必要になります。ただ、私にとってこのようなプロセスや原理を単純に説明する記事は、個人の特性を際立たせるのが難しいです。

もし誰もがほぼ同じことを話しているなら、なぜ私のを読む必要があるのでしょうか。ほとんどの人は記事を読んで問題を解決した後、誰が書いたか覚えていません。確かに記事が問題を解決したとしても、私がもっと追求したいのは「自分だけの独特な見解を持つ」ことです。

これは私が特に貴重だと思っていることです

AI、より正確には大規模言語モデル（LLM）の急速な進化により、誰もがこれまでにない低コストで新知識を学ぶことができます。そうした大AI時代において、自分を際立たせる方法はより重要になります。なぜなら、AIはまだ簡単には人と人とのつながりを置き換えることができないからです。

では、自分だけが書けるものは何でしょうか？自分を際立たせるものは何でしょうか？

私の答えは感想、見解、思想、価値観、経験、物語、これらは簡単には置き換えられないものであり、最近の記事執筆において重視していることです。

以前は、自分の感情や考えを隠そうとしていました。できるだけ客観的で中立的な記事を書こうとし、それはある種の防衛機制でした。しかし、ここ数年で自分の見解が他人と共感を呼ぶ可能性があることに気づきました。

• キャリアの次のステップ — 素早くて荒い：Huliが以前書いたフロントエンドは選択の一つにするという視点と一致しています
• インターネット上のコメントは有害：この記事が彼にどれだけ助けになったか、トロールを気にしない学びを持つ読者がいます
• 線形価値と指数価値：出力の分類方法と思考が非常に気に入っている読者がいます

深いつながりはトラフィックよりも重要

私はトラフィックを非常に気にしています。

現在、ブログの自然流入トラフィックの中で最も好調な記事はHTMLフォームの解説に関するものです：

• HTMLのFormDataを理解するために
• formタグとFormDataの応用

これらの記事では、原理の部分とフォームの使い方について触れており、ウェブサイトでほぼ必ず遭遇するものなので、自然とトラフィックを獲得しました。もちろん、Formは本当に便利です！使えるなら使いましょう！

これらの記事がブログの大部分のトラフィックを占めていますが、実際にはそれほど嬉しくありません。そこで、数週間にわたってトラフィックについて何度も考え直しました。私が気にしているのはトラフィックそのものではなく、トラフィックを通じて潜在的なつながりを引き寄せることができるかどうかです。

最も嬉しいのは、メールやプライベートメッセージで人々が記事を読んだ感想を共有してくれること、Twitterや他のプラットフォームで意見を交換し、討論することです。これはトラフィック自体よりもはるかに大きな喜びをもたらします。

もちろん、技術記事を書き続けるつもりですが、より自分の視点や考えに焦点を当てたいと思っています。これにより、読者が考えるのに役立つだけでなく、より重要なのはつながりを築くことです。