詳細構造についてのドキュメントを先に書く

仕様に関するドキュメントを先に書いてからコードを書くことは普通だろう。では、詳細構造については、ドキュメント先行は行われ得ないのか。

fjの教祖様のコメントで、「で、ドキュメントを先にします。」というところがあることから、上記の疑問が浮かんだ。

自分でも、たとえば、関数の仕様は先に決めてからコードを書き始めるけれど、中のコードは少々長いものでもドキュメント無しで書き始めるのが普通だ。でも、文章を書くときは、長くて難しいものだと、章立て考えて、各パラグラフのメインセンテンスを考えて、それを肉付けして、なんてしている。とすると、コードも文書であらすじを書いて、それをコード化していくなんて方法を取るほうが良いものが書けるかも知れないな。