ソースへの埋め込み

詳細設計書のアプローチとしてもう一つあるのが，JavaDocのようにソースへ詳細設計書を埋め込んでしまう方法である．ツールを使えばHTMLを使ったきれいなドキュメントが自動で生成され，設計書とソースの乖離が起こりにくいという利点があるが，ソースがやたらとふくらんでしまい，嫌われる場合もある．