プログラムがある程度動いたりテストが通ったりする頃に合わせて徐々にJavaDocの類のドキュメントが揃っていくのは健全
個人的にはprivateメソッドにもコメント必須と言われてもそこまで嫌な感じはしない
けどソースを1ステップも書く前からExcelで机上の空論でメソッド設計される開発フローはクソ
作りながらリファクタリングしたり軌道修正するたびにドキュメント修正のオーバーヘッドがかかる
その手間を嫌ってソースの美化も抑制される傾向が生まれるから、最終的なソースコードも導かれしクソになる定め