記事執筆による情報発信のススメ - dispatch of information with an article

職業として「執筆者 (Writer)」「編集者 (Editor)」「校正者」「校閲者」という名前を聞いたことはあるでしょうか。

• 執筆者：ステップ 1, 2, 3, 4, 5, 9, 10
• 編集者：ステップ 1, 2, 3, 5, 8, 9
• 校正者：ステップ 7
• 校閲者：ステップ 6

記事執筆は、執筆者がメインではありますが、主に作業前半のサポートを編集者が、作業後半のサポートを校正者・校閲者が行います。

編集者については、私が編集というお仕事をきちんと理解する機会がこれまでなかったので不正確なことを言っていたら恐縮ですが、執筆者と伴走して記事のネタ考察から内容の記述までをサポートしたり、場合によっては校正・校閲の作業を行ってくれる存在です。

校正者・校閲者については、その作業がそのまま職業として確立しているほど、重要かつ専門的な作業になります。プロの校正者、プロの校閲者はそれだけで職業として成り立つほど崇高なお仕事をされているということです。プロの校正者・校閲者が特に活躍されているのは、何百ページもある書籍のような分量の多い文書、あるいは執筆記事が多く何度も（異なる）文書のチェックが必要とされるような環境での校正・校閲です。（そのようなケースでは素人にはとても対応できません）

記事を執筆したいと思ったとき、何も考えなければ「執筆者」以外の役割である「編集者」「校正者」「校閲者」も自分一人で行う必要があります。知識と経験があればそれが可能な場合もあり、情報発信を多く行っている個人技術者は一人ですべてのステップを対応していることがあります。

しかしながら、経験の少ない「執筆者」であれば、それらを一人ですべてこなすことは難しいでしょう。これを解消する方法として、「メンター (Mentor)」を誰かにお願いする方法があります。編集者としての専門的知識がなくとも、前述の編集者の役割としてメンターを引き受けてくれる人は意外と多くいるのではないでしょうか。

メンター (Mentor) とは、対象者に対して支援・指導・助言を行う役割の人のことをいいます。語源は、ギリシア神話に登場するメントール (Mentor) であり、メントールが歴史的に行ってきた現在のメンターと言われるような役割を実践する人を指して、英語ではメンター (Mentor) と呼ばれるようになりました。また、メンターが行う役割（支援・指導・助言）のことを「メンタリング (Mentoring)」といいます。

技術記事を書いたりしてみたいけれど、時間が足りない、何から手をつけたらよいか分からないという人は、Twitter (X) や所属するコミュニティ等でその旨を発信してみてください。発信したい技術分野なども併せて記載すれば、その分野に関心のある有識者がメンターとして手伝ってくれるかもしれません。

もしこの記事を読んで、メンターが欲しいけれど誰に頼めばいいかわからないという人がいたら @debiru_R にご相談ください。サポートできる技術分野であれば私がお手伝いさせていただきます。

「技術系ポエム」「学習ノート」「技術レポート」「教科書」「技術論文」の5類型を提唱します。

類型	記事の目的・価値
技術系ポエム	筆者の知識や感想を記録するもの。内容の正確性は問わない。
学習ノート	筆者による理解の復習・確認やアウトプットの練習のために書かれるもの。
技術レポート	技術情報を取りまとめたもの。手を加えることで教科書となる。
教科書	読者に対する知識の提供を主な価値とするもの。
技術論文	既知の情報だけでなく、筆者の独自のアイデアや未知の情報を提供するもの。

「論文」を「技術論文」としました。単に論文というと「学術論文」を連想しやすく、それとは区別されるものであるため名称を改めました。さらに「技術系ポエム」と「技術レポート」を追加しました。

記事を目にする可能性のあるエンジニア（技術者）である読者を初心者・中級者・上級者・専門家と4つに分類し、さらに筆者自身も含めてその相性をまとめた場合、次の表のようになるでしょう。

相性の値は、「◎（有益である）」「○（価値がある）」「△（理解できない）」「―（価値がない）」「×（害悪である）」とします。

	技術系ポエム	学習ノート	技術レポート	教科書	技術論文
筆者自身	◎	◎	◎	○	◎
初心者	×	×	△	◎	△
中級者	×	×	○	◎	○
上級者	×	△	◎	―	◎
専門家	×	○	◎	―	◎

書いた記事は、筆者自身にとっては価値のあるものになります。ただし、「教科書」は自身ではなく立場の異なる他者へ向けたものであるため、自身にとっては少し読みにくいものとなる場合があります。

縦軸で見ると、「技術系ポエム」は自身以外「×（害悪である）」になっています。これは、技術系ポエムとして分類した記事は、著者の感想や思い込みによる主張が多く、技術的に正確な情報を得られる可能性が極めて低いためです。内容の正確性が著しく低い場合は、他人にとってその文書は害悪でしかないでしょう。

「学習ノート」もそういう意味では、技術的な正確性が低い可能性があります。しかしそのような文書も、専門家から見れば価値のあるものとなる場合があります。専門家は、他人に情報発信する上で、初学者をも対象読者とする文書を書くことがあります。その際に、初学者がどのような理解をしているか、どのような誤解をすることが多いかを知るためには、初学者の学習ノートというものが参考になる場合があります。

「技術レポート」は、主に中級者以上が技術的な作業をした際の作業ログであったり、技術系イベントに参加した際のブログ記事が該当します。これは「学習ノート」でもなければ「教科書」でもないため、uhyo 氏の分類に対して新規に追加したカテゴリです。

「教科書」は、文書としては「よく作られたプロダクトの公式ドキュメント」や「教材として作られた技術的記事」が該当します。教科書と一概に言ってもその実体は様々なものがありますが、主に初学者・中級者に向けて、上級者以上が書いたドキュメントが該当する場合が多いでしょう。教科書は、上級者にとって既知のことしか書かれていないことが多いため、上記の表では上級者以上には「―（価値がない）」という評価をしています。専門家にとっては、教科書は査読（批評）するものであることが多いでしょう。間違いがあれば修正を依頼します。

「技術論文」は、体系的に言語化することが容易ではない技術的内容について、それを筆者の言葉で言語化したり、その技術的内容のベストプラクティスあるいはアンチパターンを可視化したりするなど、これまで存在しなかった資料として作成される文書が該当します。

前述の表で「×（害悪である）」という評価がありましたが、著者（発信側）が「これは学習ノートです」ということをきちんと伝えていれば、その文書が公開されたところで、読者（受信側）には悪影響はありません。問題なのは、読者が教科書だと思って読んでいる文章の中身が技術系ポエムであるような場合です。

「これは何々です」という表明を明示的にすることは少ないですが、文書の冒頭あるいは末尾にそのコンテキストを明記することや、文書の書き方を工夫することで、書かれた文書がどのカテゴリ（類型）に分類される文書であるかを示すことができます。読者はそのコンテキストを読み取って、読んでいる文書がどういうカテゴリのものであるかを解釈した上で閲覧したり、批評したりします。

このとき、誤ったコンテキストが表明されていると、書き手と読み手の間に矛盾が発生します。書き手は「技術系ポエム」「学習ノート」を書いているつもりだったのに、読み手には「技術レポート」「教科書」のように読めてしまう場合などがあります。この状況では、読み手が、書き手の意図しない批評（フィードバック）をする場合があります。

書き手が「マサカリが飛んできた」と思ってしまうような状況はこうして起こります。マサカリとはいわば、想定していない攻撃的な批判です。「これは間違っている」だとか「こんな間違ったことを書くな」だとかそういう種類のフィードバックが飛んでくるのです。フィードバックを書いている側には、無闇矢鱈に攻撃的な批判をする人もいますが、一方で建設的に（攻撃する意図がなくとも）マサカリと捉えられかねないフィードバックをする人もいます。

建設的にマサカリと捉えられかねないフィードバックをする人は、「技術レポート」「教科書」だと思って読んだ記事が間違っているからフィードバックをするのです。「技術系ポエム」や「学習ノート」だと分かっている記事に対しては「間違っている」などという指摘はわざわざしません。間違っていて当然なのですから。問題はマサカリを投げられることではなく、その記事で誤ったコンテキストの表明をしていることにあるのです。

筆者だけでなく、読者が批判（フィードバック）する際にも責任は付き纏います。マサカリと捉えられかねない振る舞いをする際には、それ相応の覚悟が必要です。間違いを指摘する際には、相手とのコミュニケーションをよく考えなければなりません。これまでコミュニケーションをしたことのない相手に向かって、丁寧でない物言いは不適切なケースが多いです。

先ほど、建設的にマサカリを投げる人もいると書きましたが、マサカリと一言に言っても、丁寧なマサカリから、攻撃的なマサカリまでいろいろあります。筆者として「マサカリが飛んできた」と感じたときも、どういう人がどういう文脈でマサカリを投げてきたのかを見極め、落ち着いて対応することが肝心です。中には不適切なマサカリを投げてくる人もいます。読者が多くなると理不尽なマサカリを投げられることもありますが、あまり心配しすぎないようにしましょう。

マサカリを怖がる必要はありません。攻撃的なマサカリが飛んできたとしたら、そのマサカリを投げている人がおかしいのです。そうでなければ、記事の内容に致命的に問題がある可能性があります。でもそれは、誤ったコンテキストを表明せず、校閲プロセスを実施していれば防げるはずです。

• 技術記事の3類型: 初心者による技術記事執筆のすすめ - uhyo