むかしの話ですが 「もうすぐA案件と類似のB案件が始まるから、まずはA案件のキャッチアップしといて。」みたいな話があってドキュメント地獄にハマりました。 今日はそのことについて。 SI業界で働いていると割りとよく聞く発言で 「ここの現場はよくドキュメント化されている方だと思うよ。」というのがあります。 つまりソースコードを補完する十分なドキュメントがあるのでここは出来た現場だ、ということです。 ・・・果たしてそうでしょうか? こんな構成のディレクトリ、よく見ますよね。 これだけ見ると確かにきちんと整理されていそうな気もします。 ですが実態はたぶんこんな感じではないでしょうか? 03_基本設計ディレクトリ配下には当然のように「基本設計書以外のもの」が格納されています。 これを見て「別に普通じゃない?」と思ったそこのあなた!! あなたはかなりSI業界に毒されていますw SI業界では各フェーズに
![マインドマップをドキュメント地獄から抜け出す糸口とする - ITエンジニアとして生きる](https://cdn-ak-scissors.b.st-hatena.com/image/square/d42e50a0692ef41c88aaa3099062f84184acc506/height=288;version=1;width=512/https%3A%2F%2Fcdn-ak.f.st-hatena.com%2Fimages%2Ffotolife%2Fo%2Fogin_s57%2F20130226%2F20130226204150.png)