SEに関しての質問なのですが、PJのソースコードをある程度理解し、定義書などを書けるようになるまで一般的にはどのくらいかかるのでしょうか？ その言語は未習得であるとします。

Question

なぜ気になったのかというと、自分は2年目のSEで、最近参画したPJで同じような状況になったからです。
1年目に多少実装経験があるとはいえ、ほぼ勉強したことない言語で書かれたPJのソースコードを読み、今週中に定義書のリファクタをするように言われました。
期限を考慮して範囲が限られていることは救いですが…
とはいえ大量のソースコードの中からどこで何をしているのか把握するのも含め、個人には2〜3週間欲しいと感じるところなのですが、それでは遅すぎるのでしょうか？

Answer 1

開発ツールを使ってステップ実行できれば初めての言語でも定義書ならまずまずの速度で仕様を拾うことができるだろうと思います。
コードを読むだけだと2倍くらいは時間がかかるかもしれないという印象です。

個人的には、「コードを読むだけで追えというようなやり方ならまともな結果は出せない可能性があります」と言ってしまいますね。
2～3週間欲しいなら、そのように要求されてはと思います。

Answer 2

未習得の言語を簡単にザックリ読めるようになること自体は1日あればできますね。あくまで「簡単にザックリ」ですが。
あとはソースの規模や、作り方によるでしょう。
よく慣れている言語でも、なんじゃこれ？ 何やってんのこれ？？ と、しばしチンプンカンプンになるようなソースもありますよ。それが未習得な言語だと読解はキツいですね。

単純なソースであれば、1週間でやることは不可能ではないと思います。設計書は無理ですけど、定義書なら。