関わるプロジェクトのシステムの構成や仕様の理解のスピードを上げる方法はあるだろうか

仕事のこと。

現在はテストのフェーズ。
今日の課題として、システム構成や仕様の理解にかかる時間をもう少し短縮できないかということ。

まず、自身のやり方を振り返ってみる。
仕様書とデザインを確認する。
仕様書に具体的な計算仕様が書かれていなかったため、そのままバグに関わる部分のコードをデバッグしながら、実装で仕様を理解しようとしたが、
複雑で時間がかかりそうと途中で気づく。
そこで、デザインに戻り、どのような結果を出力したいか、から再度仕様の理解をしようとする。
ある程度わかったがここまで辿り着くまでにだいぶ時間がかかってしまった。

次に同じような場面で取るべき方針は？

1. そもそもドキュメントが散らばっていて、google docsにあるのか、notionにあるのかfigmaにあるのか。全てに当たって探すことから始まる。今度ドキュメント管理から任せてもらえる時は、一箇所にまとめる。もし必要があって分けるにしても親をどちらかとして設定し、必ず親からすぐに参照できる形で管理する。

2. その上で、まず仕様の理解でつまづいたら、ドキュメントを網羅的に探す。一通りに目を通す。

3. デザインを見る。

4. ここでまでで、得たい結果・実装がわかっている状態にする。

5. その上でコードを見る。

これでやってみようと思う。