この記事のテーマは、調査の進め方と同僚間の協力方法です。これは私が以前の仕事で技術調査を行った際の考えをまとめたものであり、すべての人に適しているわけではありません。(関連書籍も読んでいません)
(ここに画像を挿入)
調査の方向を明確にする#
調査を行う前に、まず調査の目標とロードマップを明確にし、これらの計画と期待を関連する同僚と共有する必要があります。このプロセスでは、考えを整理することが重要です。同僚とのディスカッションは考えを整理するための良い方法です。
調査を実施する人と依頼者は通常異なるため、依頼者のニーズを確認する必要があります。調査を開始する前に、自分の理解を簡潔にまとめて調査内容を説明し、依頼者と確認することができます。ニーズが明確でないと、調査の方向が間違ったものになる可能性があります。例えば、GitHub Action の調査では、ニーズが明確でなかったため、結果的に調査の焦点が間違った方向に置かれました。
調査の重点を把握する#
調査のキモは「どの情報が価値があるかを判断すること」であり、範囲を絞ることに重点があります。例えば、本の調査では、すべての知識ポイントをリストアップするべきではなく、私たちにとって価値のある部分を抽出する必要があります。そうしないと、ただの情報の羅列になってしまい意味がありません。
スタートアップ企業では、私たちは得意ではない領域や新しい領域に取り組むことがよくありますので、新しいメンバーに調査を依頼するのは難しいです。なぜなら、彼らが私たちの仕事にとってどの情報が価値があるかを判断することができないからです。これが新人に直接技術書を読むことをおすすめしない理由です。読まないというのではなく、目的もなく読むべきではないということです。
調査の対象は何か#
その技術がどのような問題を解決するのかを明確にすることです。私たちが調査する技術は通常、実際の問題を解決するために使用されるものですので、その問題の範囲を明確にする必要があります。
さまざまな解決策を比較し、選択肢がある理由を理解する必要があります。
その技術の使用シナリオを特定することで、その技術が私たちに適しているかどうかを判断することができます。
クラシックなケースを作る#
調査では、GitHub Action のワークフロー、ステップ、ジョブなどの抽象的な概念が関わることがありますが、これらを言葉だけで説明するのは難しい場合があります。その場合、クラシックなデモを作成し、概念を組み込むと効果的です。デモは簡潔であり、より多くの機能を含んでいる必要があります。
その他(科学普及と調査の関係について)#
科学普及と調査には共通点があります。それは、「他の人が接触していない知識を、他の人が理解できる言葉で説明する」という点です。ここで思い出すのは、「科学の話」の著者である汪洁さんが言及していることです。彼は「科学普及作家の仕事は、情報の海から真実で正確かつ客観的な情報を引き出し、自分の言葉で一般の人々に普及させ、理解しやすく吸収できるようにすることです」と述べています。また、阮一峰の記事が非常に人気があるのは、彼の記事が実際に科学普及文と非常に似ているからです。
まとめると、技術調査では方向を明確にし、重点を把握し、技術が解決する問題を説明し、クラシックなケースを作り、複雑な概念をわかりやすい言葉で伝えることが重要です。これらの個人的な経験があなたの調査に役立つことを願っています。