山下寛人オフィシャルブログ

オイシックス株式会社 執行役員 システム本部長 山下寛人の公式ブログです。

Coolなドキュメント

Beginning comfortable documentation with jenkins and doxygen ( public )

このスライドの中に

SIer時代に書いたCoolなドキュメント

というのがあります。

まさに無駄なドキュメントの典型で、笑えます(笑

エクセル方眼紙というのもポイントが高いですね!


役割のわからないクラス名とかいいところ

ついていますね。

プログラム名に人間が読める名前でなくコードを

つけざるを得なかったのは、大昔のメインフレーム

などでは8文字以内という制約があったからです。

長さに制限がなければ人間が読める名前をつけたほうが

いいに決まっています。

パッケージによってグループ化することもできます。


こういう無駄に気づいて合理化してコストを下げたら

SIerもまだまだ伸びるのでは。