🦜

新人向け PJジョイン時の質問シート

2024/03/07に公開

初心者

はじめに

既存商品の開発案件に参加した際、自分が知らなくて困ったことをQ&Aシートにまとめました。
新人のうちはシステムの仕様や社内の開発環境について学習しながら開発もしていくことになります。
PJ初期の段階で十分な情報を手元に持っておくことで、自分で調べられる範囲が広がり、かつ「聞かないとわからない」ことなのか、「調べれば十分解決可能」なのかの切り分けに役立つと思います。

質問リスト

環境構築

開発環境の場所とアクセス手順を教えてください。
- バージョン管理システム
- 進捗管理ツールなど
環境構築のうちこのプロジェクトに必須のものはどれですか？
- 「環境構築手順書」のようなものがすでにある場合は聞いておくとよさそう

予備知識の学習

商品の仕様などの知識を得るために読んでおくべき社内の資料はありますか？
- 顧客向け資料
- ユーザーズガイド
- 仕様書
- 設計書など
稼働している商品を実際に、または動画で見ることはできますか？
- ターミナルにログが出るぐらいであっても、一応見ておいて損はないと思われる
開発に必須となる技術的な知識を得るためのキーワードを教えてください。
- 主に自習として本やネットで勉強する用
  - 「ネットワーク」「Web系」とかだと粒度が大きすぎるので、「ソケット通信」「REST API」ぐらいのキーワードで教えてくれると嬉しい

プロジェクト組織図

プロジェクトメンバーの役割を教えてください
- 困ったときにまずは誰に聞けばいいですか？

開発

すでにあるコードの中で近い機能を扱うものはありますか？
ターゲットとなる機能ではないが、必須の機能はありますか？
- 作るのがアダプタやプラグインだと、「骨組み」に沿って開発する必要があったり、ターゲット機能以外の必須機能(統計出力など)があることがある
商品に関連するライブラリはありますか？
- それについて聞きたいことがある場合、誰が詳しいですか？
  - 主に内製のライブラリを想定

試験

テストコードとして流用できるものがあれば教えてください。
単体試験に関する資料で参考になるものはありますか？
- 社内/部署で流通するテンプレートなど、あると嬉しい
結合試験に関する資料で参考になるものはありますか？

全体の流れ

ハードウェア制約のテストなどのため、先に試作しておくべきモジュールはありますか？

おわりに

「自分が」ほしかった情報を書いているので、人によっては連絡系統(定例ミーティングがあるか/をやるか、コミュニケーションツールはどうするか)や責任範囲など追加で聞いたほうがいいこともあるかもしれません。