仕様書書くのって面倒ですよね。
でも、ユーザーへの説明や引継ぎを考えると全くないっていうのも考え物。

Javaだと、javadocっていうのがあって、コメントからhtmlやlatexのドキュメントを自動生成する枠組みが用意されています。
C/C++でも同様のことを実現してくれるのがdoxygenです。
glibcのSTLのコードにも使われたりして、結構普及しているようです。

こちらのサイトにマニュアルの日本語訳と使い方の説明なんかがあります。
http://www.fides.dti.ne.jp/~oka-t/doxygen.html
Let's use doxygen!

使用されたことのない方は一度試されることをお勧めします。