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